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ASSEMBLER-16 
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PACKAGE 


CUSTOM MANUFACTURED IN U.S.A. BY RADIO SHACK, A DIVISION OF TANDY CORPORATION 


TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK COMPUTER EQUIPMENT AND SOFTWARE 
PURCHASED FROM A RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL STORE OR FROM A 
RADIO SHACK FRANCHISEE OR DEALER AT ITS AUTHORIZED LOCATION 


LIMITED WARRANTY 


CUSTOMER OBLIGATIONS 


A. 


CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the Equipment’). and any copies of Radio 
Shack software included with the Equipment or licensed separately (the “Software’) meets the specifications, capacity, capabilities, 
versatility, and other requirements of CUSTOMER. 

CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software 
are to function. and for its installation. 


RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. 


D: 
& 


For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment. RADIO 
SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects. THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT BY THE ORIGINAL CUSTOMER FROM 
RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS 
AUTHORIZED LOCATION. The warranty is void if the Equipment’s case or cabinet has been opened, or if the Equipment or Software has been 
subjected to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period, the defective Equipment 
must be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Snack dealer 
for repair, along with a copy of the sales document or lease agreement. The original CUSTOMER'S sole and exclusive remedy in the event of 
a defect is limited to the correction of the defect by repair. replacement. or refund of the purchase price, at RADIO SHACK’S election and sole 
expense. RADIO SHACK has no obligation to replace or repair expendable items. 

RADIO SHACK makes no warranty as to the design, capability, capacity. or suitability for use of the Software, except as provided in this 
paragraph. Software is licensed on an ‘AS |S” basis. without warranty. The original CUSTOMER'S exclusive remedy, in the event of a 
Software manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document 
received upon jicense of the Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, 
participating Radio Shack franchisee or Radio Shack dealer along with the sales document 

Except as provided herein no employee. agent, franchisee. dealer or other person is authorized to give any warranties of any nature on behalf 
of RADIO SHACK. 

Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 

Some states do not allow limitations on how long an implied warranty lasts. so the above limitation(s) may not apply to CUSTOMER. 


LIMITATION OF LIABILITY 


A. 


EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON 
OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
EQUIPMENT’ OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO. ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE 
USE OR OPERATION OF THE ‘EQUIPMENT’ OR “SOFTWARE”. IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR 
ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER 
ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE “EQUIPMENT” OR “SOFTWARE”. 


NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 
CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR “EQUIPMENT” OR “SOFTWARE” 
INVOLVED. 

RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years 
after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or 
Software, whichever first occurs. 

Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may 
not apply to CUSTOMER. 


RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software on one computer, subject to the following 
provisions: 


A. 
B. 


C 
D. 


G. 


Except as otherwise provided in this Software License, applicable copyright laws shail apply to the Software. 

Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to 
the Software. 

CUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits this 
function. 

CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as Is specifically 
provided in this Software License. Customer is expressly prohibited from disassembling the Software. 

CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or If additional copies are required in 
the operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However. for 
TRSDOS Software, CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER'S own use. 

CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each 
one sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

All copyright notices shall be retained on all copies of the Software. 


APPLICABILITY OF WARRANTY 


A. 


The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER. 

The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and/or licensor of the 
Software and any manufacturer of the Equipment sold by RADIO SHACK. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rignts, and the original CUSTOMER may have other rights which vary 
from state to state. 
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PROGRAMMING PACKAGE 


TRSDOS '™“-IT Operating System: Copyright 1982 Tandy Corporation. All 
Rights Reserved. 

TRSDOS'™16 Operating System: Copyright 1982 Ryan-McFarland Corporation. 
All Rights Reserved. Licensed to Tandy Corporation. 

EDIT16 Software: Copyright 1982 Ryan-McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 

ASM16 Software: Copyright 1982 Ryan~McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 

LINK16 Software: Copyright 1982 Ryan-McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 


TRS-89® Assembler-16 Programming Package: Copyright 1982 Tandy 
Corporation. All Rights Reserved. 


Reproduction or use without express written permission from Tandy Corporation, 
of any portion of this manual is prohibited. While reasonable efforts have 
been taken in the preparation of this manual to assure its accuracy, Tandy 
Corporation assumes no liability resulting from any errors or omissions in this 
manual, or from the use of the information obtained herein. 
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TO OUR CUSTOMERS... 


The Assembler-16 Programming Package contains three systems 
for developing programs in MC689#M object code: 


The EDITOR (EDIT16) which allows you to create 
and edit "source" assembly language programs 


The ASSEMBLER-16 (ASM16) which assembles 
the source program into an intermediate 68999 
object code program. 
The LINKER (LINK16) which links the intermediate 
object code program into an absolute executable 
program file. 

Also, as part of the TRSDOS-16, you can use: 


The DEBUGGER (DEBUG) for debugging the 
absolute program. 
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ABOUT THIS MANUAL 
This manual contains two sections: 


Section 1/ Operations explains how to use the 
four systems. 


Section 2/ Assembler-16 Reference Guide references 
the assembly language required by the Assembler-lé6. 


The terms and notations the manual uses are: 


ALL CAPS 
indicates what will appear on your screen or what you 
should type. 


<KEYBOARD CHARACTER> 
indicates keys you press. 


lowercase underlined 
represents words, characters, or values to be supplied by 
you or the system. 


filespec 
is a standard TRSDOS-16 file specification, described in 


the TRSDOS-16 Manual, having the general form: 
filename/ext.password:drive(disk name) 


The notations and terms accepted by the Assembler-16 are in 
the beginning of Section 2. 
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CHAPTER 1/ SAMPLE SESSION 
This chapter shows how to use the Assembler-16 Programming 
Package to create, debug, and execute a 689% object 
program. 
This is for demonstration purposes only. For complete 


information on each system's commands, listings, and error 
messages, see the appropriate chapter. 


DEVELOPING A 68988 PROGRAM 
To develop a 6899M program file, follow these steps: 


1. Create one or more source program files 
(with the Editor) 


2. Assemble the source files into intermediate 
object files (with the Assembler) 


3. Create a linker control file (with the Editor) 
4. Using the control file, link the intermediate 
files into an absolute program file (with the 
Linker ) 
1. Creating a Source File 
To create the source file, type: 
EDITL6 <ENTER> 
which loads the Editor. At the C? prompt type: 
IN <ENTER> 


which enters the insert mode. At the I? prompt, insert this 
program: 


BEGIN LDA .AG,SVC BLOCK *load svc block 
MOVW @AG,#8 *store vdchar svc 
MOVW 6@AG, #65 *store 'A 
BRK #6 *execute vdchar 
Radie Shaek 
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| 
LDA -A®,SVC BLOCK *load svc block 
MOVW @AQ,#264 *store jp2dos svc 
BRK #0 *execute jp2dos svc 
SVC BLOCK 
RDATAB 3258 *reserve svc block 
END BEGIN 
Use <ENTER> to enter each line; <TAB> to tab between 
columns. (The Editor displays the <TAB> as an + character 
rather than tabbing.) 
This assembly language program contains Assembler-16 
instructions, described in Section II, and TRSDOS-16 
sVCs, described in the TRSDOS-16 Operating System Manual. 
If you need to edit the program, see Chapter 2. 
Otherwise, save it and exit the Editor with: 
! <ENTER> 
SAVE SAMPLE/SRC <ENTER> 
OUIT <ENTER> 
You should now have a source disk file named SAMPLE/SRC. 
Note: After using an SVC, you should normally . J 


check offsets 2 and 3 for an error code. For 
Simplicity, this program does not do this. 
2. Assembling an Intermediate File 
To assemble SAMPLE/SRC, type: 
ASM16 SAMPLE <ENTER> 
which causes the Assembler to load and then assemble 
SAMPLE/SRC into "intermediate", relocatable object code. 


It then saves the intermediate code on disk as a file 
named SAMPLE/OBJ. 


3. Creating a Control File 


To create a linker control file, load the Editor and 
insert this program: 


INCLUDE SAMPLE 
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END 


INCLUDE and END are directives controlling the Linker 
(discussed in Chapter 4). 


SAVE this program as a file named SAMPLE/CTL and exit the 

Baitor, 

4, Linking an Absolute Program File 

To link the program file, type (at TRSDOS-16 Ready): 
LINK16 SAMPLE <ENTER> 

which loads the Linker and then loads SAMPLE/CTL. 

The Linker links the one file which SAMPLE/CTL directs it 

to INCLUDE -- SAMPLE/OBJ -- to absolute addresses 

beginning with address O@9@@M. (You could INCLUDE other 


intermediate files, as well.) 


The Linker saves this as an executable program file named 
SAMPLE. 


Refer to Chapter 4 for a complete listing of all the 
options to the linker command. 


EXECUTING THE PROGRAM 


Since SAMPLE is an absolute, executable program file, you 
can execute it from the TRSDOS-16 Ready mode. At 
TRSDOS-16 Ready, type: 


SAMPLE <ENTER> 


TRSDOS-16 loads and executes SAMPLE beginning at the 
"relative" address of @9@@. 


Note that address 999M is relative. TRSDOS-16 loads 
itself and the Debugger, if present, in an area of memory 
that is "invisible" to the user. The relative address of 
9G9GW is actually the first address available after 
TRSDOS-16 and the Debugger. 
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Because TRSDOS-16 uses relative addresses, you need not 
be concerned about loading your program over system 
memory. 


DEBUGGING THE PROGRAM 


If you need to debug the program, you can use the 
Debugger. At TRSDOS-16 Ready, type: 


DEBUG ON <ENTER> 
SAMPLE <ENTER> 


which turns on the Debugger and then loads SAMPLE. If 
the Debugger does not activate, you will need to 
configure it into system memory. Appendix D explains 
how. 


Once SAMPLE is loaded into the Debugger, you can use any 
of the Debugger commands. For example: 


N <ENTER> 
executes the SAMPLE's first instruction. 
V LA <ENTER> 
displays the contents of addresses §@1A through 9929. 
To exit the Debugger and return to TRSDOS-16 Ready, type: 


O <ENTER> 
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THE EDITOR 
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CHAPTER 1/ THE EDITOR 


The Editor is a set of commands that allows you to create 
and edit text files. 


You can use the Editor with: 
1. The Assembler-16 
2. The COBOL Compiler 
3. The TRSDOS-16 DO command and Configuration command 
file 
It allows you to: 


i Create files. 


You can write your own programs and save them to disk for 
future use. 


Li Edit existing files. 
You can change the program lines or contents of a rile; 
S33 Combine files. 


You can combine multiple programs together into one program. 


LOADING THE EDITOR 
This command, typed at TRSDOS-16 Ready, loads the BALtcor : 


EDIT16 source filespec {options} 


source filespec is optional. It causes the Editor to 
CONCATenate the specified source filespec. 


The options are: 


W=drive tells the Editor which drive to use as its 
work file. 
M=drive tells the Editor which drive to use as a 


"scratch file" during a MOVE. 
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WORK AND SCRATCH FILES 
W=drive 
As the Editor creates or edits a program, it does not use 
its own memory to do so. It stores your program on disk in 


a temporary "work file". You must have enough space on disk 
for this file, otherwise you get a disk-full error. 


The W=drive option tells the Editor which diskette to use 
for the work file. In this way you can save your good 
diskettes from excessive writes and deletions. 


If drive is not a valid drive specification, EDIT16 will 
not load and you will be returned to TRSDOS-16 Ready. 


M=drive 

When you use the Editor's MOVE command, the Editor creates 
another temporary disk file called a "scratch file". 

The M=drive option tells the Editor which diskette to use 
as its "Scratch file". Again, this will save wear and tear 
on your good diskettes and files. 


If drive is not a valid drive specification, the Editor 
will use the first available drive for the scratch file, 


SAMPLE SESSION 


fo -enter the Editor, type: 
EDIT16 <ENTER> 


and the Editor displays the prompt: 


This is the Editor's Command mode. You can use any of the 
Editor's commands in this mode. 


To create a program in the Editor, you must get in the 
Insert mode. At the C? prompt, type: 


IN <ENTER> 
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The Editor displays the I? prompt -- indicating the Insert 

mode. Type in the following program lines. The asterisk 


(*) indicates comment lines: 


THIS IS A PROGRAM <ENTER> 
THAT WILL DEMONSTRATE <ENTER> 
ALL OF THE TRSDOS=1L6 <ENTER> 
EDITOR'S COMMANDS <ENTER> 
<ENTER> 


+ + + + 


When you press <ENTER>, the Editor exits the Insert mode. 
The Editor keeps this file in its work file until you delete 
the lines, SAVE the file, or exit the Editor. 


To see what you've just entered in the Editor's work file, 
LYDe: 


LIST ALL <ENTER> 
and the Editor returns a complete program listing: 


THIS IS A PROGRAM 
THAT WILL DEMONSTRATE 
ALL OF THE TRSDOS-16 
EDITOR'S COMMANDS 


+ FF 


Notice there are no line numbers in this program. To give 
it line numbers, you must first save your program by typing: 


SA SAMPLE1/PRO <ENTER> 
This writes the program as SAMPLE1/PRO to disk. 


After saving the program, delete all information from the 
Editor's work file by typing: 


DE ALL <ENTER> 


(The Editor prompts you with CANCEL = 'X'; type <ENTER> to continue 
the DElete command. See DELETE for details.) 


Next type: 


CO SAMPLE1/PRO <ENTER> 
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to load -- CONCATenate -- the program into the Editor's work 

file. (See the appropriate Editor's command for details on 


its use.) 
Your program is now in the Editor's work file with numbers: 
1 * THIS IS A PROGRAM 
2 * THAT WILL DEMONSTRATE 
3 * ALL OF THE TRSDOS-16 
4 * EDITOR'S COMMANDS 


An alternate way to load your program into the work file 
(after you've SAVEd it) is to exit the Editor. Type: 


QU <ENTER> 


Then reload the Editor and the file at the same time by 
typing: 


EDIT16 SAMPLE1/PRO <ENTER> 


LINE NUMBERING 


The Editor provides for two types of line numbrs: 
‘ relative line numbers 
‘ absolute line numbers 
Relative line numbers 
When you initially create a program, the Editor does not 
assign line numbers. You can reference these unnumbered 


lines via relative line numbers. 


Relative line numbers are: 


$ the current line 
2h the current line minus n lines 
S+n the current line plus n lines 


For example, to refer to a line five lines before the 
current line, use the relative line number $-5. To refer to 
a line nine lines after the current line, use $+9. 
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Absolute line numbers 

An absolute line number is the actual number which the 
Editor gives a line when you first CONCATenate the file into 
a. Work. £1ie. 


An "absolute line number" can be: 


r a whole number, including zero (f) 
‘é START 
. END 


Whenever the Editor concatenates a file into an empty work 
file, it assigns each line a whole number beginning with l. 


Although the Editor never assigns a line %, you can use Ve 
to insert lines at the beginning of the program. The 
commands CONCATenate, MOVE, and INSERT are the only ones 
that recognize a reference to line Q@. 


START and END refer specifically to the first or last line 
of the program. 


REFERENCING PROGRAM LINES 


The following commands allow you to specify one line or a 
group of lines. 


line 

refers to a single line of the program. This single line 
can be either an "absolute line number" or a "relative line 
number". 


Some examples of line as an absolute line number are: 


START Refers to first line of program 

23 Refers to line number 23 

1958 Refers to line number 1958 

END Refers to last line of program 

g Refers to the line preceding the first 


line of the program 
Some examples of line as a relative line number are: 


$ Refers to the last line the work file 
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displayed -- the current line 
$-7 Refers to the line that is seven lines 
before current line. 
$+6 Refers to line that is six lines after 


the current line. 


lines 
When you see lines in the command's syntax, you can enter: 
- One line 
to indicate a single line only. 
- ALL lines 
to indicate every line of the work file. 
; A pair ot Lines 
to indicate all lines between and including the pair of 
lines. To separate the line pair, use a comma (,), period 


(.), or hyphen (-). 


When you specify a pair of lines, you cannot mix absolute 
and relative line numbers. For example: 


2-4 and $-2,$ 
are valid pairs of lines to reference. Both 2 and 4 are 
absolute line numbers. Both $-2 and $ are relative line 
numbers. 


$,2 and START-S$ 


are not valid because $ and 2 and START and $ reference 
both relative and absolute line numbers within one pair. 


When specifying a pair of lines in a command, be sure to 
put the earliest line in the program first. You can use the 
pair $-6,$-4, but not $-4,S$-6. 


some more examples of pairs of lines are: 


START, 23 Refers to all lines from the first to 
line 23. 
971-1923 Refers. to Janes 971. through 1923. 
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S=7,8=2 


146,END 
Sato 


START. END 


TRS-80 ® THE EDITOR 


Refers to the entire contents of the 
work file. 

Refers to the lines from the seventh 
before the current line to the 
second before the current line. 
Refers to lines 146 to the end. 
Refers to the lines from the current 
line to the line three lines after the 
current line. 

Refers to the entire contents of the 
work file. 


SPECIFYING STRINGS 


Three more terms to know when specifying a string to search 


for are: 


delimiter 


string 


You can use the 


CONCAT 
LIST 
MOVE 
PRINE 


indicates a character used to mark the 
beginning and end of distinct variables. 


indicates a set of characters. These can be 
any alphanumeric characters including 
blanks. 


indicates a Global search. When G is 
specified, the Editor will search for each 
occurrence of the specified string within 
the given range. Without G, the Editor 
stops at the first occurrence of string. 


USING THE <BREAK> KEY 
<BREAK> key in the Editor with these commands: 
SAVE 


SEARCH 
STRING 


When you press <BREAK> with any of these commands, the 
Editor will display the last line of operation and will 
return to the command mode -- C? prompt. 


NOTE: Be careful when using <BREAK> with the SAVE and 


STRING commands. 


If you press <BREAK> while executing one 
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of these commands, part of the work file (with STRING) or 
the disk file (with SAVE) will be altered. 


ENTERING AN EDITOR COMMAND 


The following pages list all the Editor's commands. You 
may enter them by typing either: 


‘ the entire command (SAVE FILE <ENTER>) 
r the first two letters of the command (SA FILE 
<ENTER ) 


Most commands allow you to specify an expression. 


If the expression begins with an alpha-character (A through 
Z), you must leave at least one blank space between the 
command and the expression (SA NEWFILE rather than 
SANEWFILE). 


If the expression begins with a number, you do not need to 
type an intervening space (both IN 19% and IN1@@ are 
GOTrece)., 
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CHANGE 

CH line 
allows you to change line. 


line is optional; if omitted, the Editor displays the 
current line for you to change. 


Once you enter this command, the Editor displays the I? 
prompt. To change the line, type the new line followed by 
<ENTER>. 


If you decide not to change the line, press <ENTER>. 


Examples 

With our sample program inserted, type (at the C? prompt): 
CH 1 <ENTER> 

and the Editor displays: 


i * THIS 15 A PROGRAM 
ds 


Change line 1 by typing: 
* THIS IS A NEW PROGRAM <ENTER> 


The Editor then displays the new line 1 and returns to the 
Editor's command mode. 
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CONCAT 
CO (line) filespec (lines) 


inserts (CONCATenates) the contents of fLIESpec into the 
BoOLtor . 


line is optional and can only be used when the work file 
already contains a program. It indicates where in the work 
file to insert filespec. If omitted, filespec is 

inserted at the current position. 


lines is optional and tells the Editor to only CONCATenate 
the specified lines from filespec. If omitted, the entire 
file is inserted. 


Both line and lines must be enclosed in parentheses ( ). 


Examples 


Before entering this example, delete everything in the work 
Pile by typing: 


DE ALL <ENTER> 
To CONCATenate SAMPLE1/PRO into the work file, type: 
CO SAMPLE1/PRO <ENTER> 


The Editor loads the file SAMPLE1/PRO from disk, displaying 
the last line with its new line number. 


To see the entire listing of the file, type LI ALL <ENTER> 
and the Editor displays: 


THIS IS A PROGRAM 
THAT WILL DEMONSTRATE 
ALL OF THE TRSDOS-16 
EDITOR'S COMMANDS 


Wh 
+ + + 


To CONCAT lines into a program already in the work file, 
type: 


CO (2) SAMPLE1/PRO (2-3) <ENTER> 


The Editor inserts lines two and three of SAMPLE1/PRO after 
the second line of the current program in the Editor. 
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(After the Editor CONCATenates lines, it displays the last 
of the lines being inserted.) 


Type LI ALL <ENTER> to see all of the Editor's contents: 


1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 
* THAT WILL DEMONSTRATE 
* ALL OF THE TREDOS—L6 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 


When the Editor concatenates lines of a file into a program 
already in a work file, it doesn't add line numbers to the 
most recently CONCATenated lines. 
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DELETE 
DE lines 
deletes lines. 


If you do not specify lines, the Editor deletes the 
current line. 


If you specify lines as ALL, the Editor prompts you with: 
CANCEL = 'X'! 
Type X <ENTER> to cancel the DElete command. If you really 
do want to delete all the lines, press <ENTER>. 
Examples 
With the Editor's current position at the END of the work 
file, you can delete the two lines we inserted in the last 
example by typing: 
DE $—3,5-2 <ENTER> 
The program will again be: 
* THIS IS A PROGRAM 
* THAT WILL DEMONSTRATE 


* ALL OF THE TRSDOS-16 
* EDITOR'S COMMANDS 


Hm W Nh Fe 


To delete the entire program, type: 
DE ALL <ENTER> 

Before actually deleting the lines, the Editor prompts: 
CANCEL = '‘'X' 


Type X <ENTER> to cancel the DElete ALL command. (If you 
really do want to delete all the lines, press <ENTER>). 
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IN line 


enters the Insert mode, displays the I? prompt, and allows 
you to insert lines after the referenced line. 


To terminate the Insert mode, type ! <ENTER> or simply 
<ENTER> at the beginning of an Insert line. The Editor will 
display the last line that you inserted, followed by the 
command mode prompt -- C?. 


If you don't specify line, insertion begins after the 
current line. 


Examples 


If you have the sample program entered in the Editor and 
want to insert new lines after the fourth line, type: 


IN 4 <ENTER> 
The Editor displays: 


4 * EDITOR'S COMMANDS 
‘Creer: eee eee See ee ee ee 


You are now in the Insert mode and can now insert lines 
after line 4. Type: 


BEGIN<TAB>LD<TAB> .A%, #TABLEXTAB>*load start of table <ENTER> 
<TAB>BNE<TAB>DONE<XTAB>*if no match go to DONE <ENTER> 
<ENTER> 


When you press the <TAB> key in the Insert mode, you'll see 
+ . This represents the <TAB> key. The tabstops are 
preset to multiples of eight, i.e., tabstops at 8, 16, 24, 
6 VP ee ca ie (To set your own tabs, see the TAB command later 
in this chapter.) 


To see the tabbed inserted lines and the rest of the 
program, ab tne Cr prompt, Cype: 


LI ALL <ENTER> 


and the Editor displays: 
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1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

BEGIN LD AS, #TABLE *load start of table 
BNE DONE *if no match go to DONE 

To insert lines at the beginning of a program, type: 

IN@ <ENTER> 
you'll see the I? prompt. You can now insert lines which 
will precede the first line of the program. For example, 
type: 

« LEP" S LOOK AT PHE EDITOR <ENTER> 

<ENTER> 
This inserts * LET'S LOOK AT THE EDITOR as the first line of 
the sample program. 
To insert a line at the end of the program, type: 

WwW 


IN END <ENTER> 
You can now add lines at the end of the program. Type: 


<TAB>MOV<TAB>.D2,.D@0+<TAB>*otherwise move element number <ENTER> 
<ENTER> 


to enter one more line. 
Save this new program by typing: 


SAVE SAMPLE2/PRO <ENTER> 
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LI lines 


displays lines and positions the Editor to the last line 
listed. 


lines is optional; if omitted, the Editor lists the 
current line. 


If you attempt to list more than 21 lines (more than the 
screen can display at one time), the Editor displays the 
first 21 lines and then returns the message: 

CANCEL = ‘'X' 
If you press <ENTER>, the display will continue. If you 


type X <ENTER>, the Editor stops the LISTing and returns to 
the command prompt. 


Examples 
LI ALL <ENTER> 


returns a complete listing of the current program. [In this 
case, the Editor displays: 


* LET'S LOOR ALT THE EDITOR 
1 * THIS IS A PROGRAM 
2 * THAT WILL DEMONSTRATE 
3 * ALL OF THE TRSDOS-16 
4 * EDITOR'S COMMANDS 
BEGIN ED Ag’, #TABLE *load start of table 
BNE DONE ‘ir nO: MaAtcn. go-to. DONE 
MOVE -D2;<2D0 *otherwise move element number 


To obtain a listing of the first unnumbered line at the 
beginning of the program, type: 


LIST START <ENTER> 
and the Editor returns this listing: 


* LET'S LOOK AT THE EDITOR 
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MOVE 
MO (lines) TO line 
duplicates lines and places them after line. 


lines is optional. If omitted, the Editor moves the 
current line. 


line is optional. If omitted, the Editor places lines 
after the current line. 


You must enclose lines with parentheses (). If you do 
not, the Editor returns an error. 


Note: Use the DELETE command (See DELETE) if you want the 
MOVEdG line(s) deleted from the original position in the 

El Le. 

Examples 


MO (START)TO END 


moves the first line of the program to the end of the 
program. 


MO (1-2)TOS 


moves all lines between and including lines 1 and 2 to 
follow the current line. 


MO(S$-2)TO $ 


moves the line two places before the current line to follow 
the current line. 


MO TO 4 
moves current line to follow line 4. 
MO 


moves current line to follow current line. (Has the effect 
of repeating the current line). 
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Use the DElete command to get rid of any of the lines you 
MOved that you don't want duplicated in your program. First 
LI ALL lines, then type: 


DES-3,$ <ENTER> 
DES-3 <ENTER> 
DES-3 <ENTER> 


This returns the program to the contents we will reference 
in the remainder of this section. 
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POSITION 


FO tn 

PO = 5 
moves the Editor's current position plus (+) or minus (-) 
n lines and then displays the new current line. 


Typing PO 1s optional; if you simply type +n or <n, you 
can position the Editor. 


nis optional. If you specify it, n can be any whole 
number. If n is greater than the number of lines in the 
program, the Editor returns: 
**TTEM NOT FOUND** 
and moves the current position to the beginning or end of 
the program (beginning if you specified minus (-), end if 
you specified plus (+)). 
If you do not specify n, the Editor uses l. 
Once you enter the POsition command, whenever you simply 
press <ENTER>, the Editor will move one line forward or WwW 
backward, depending on the POsition command you originally 
entered. To exit this command, enter another of the 
Editor's commands. 
Examples 


Using the sample program, SAMPLE2/PRO, position the Editor 
to the end by listing the entire program. fType: 


LI ALL <ENTER> 


and the Editor displays the current program: 


* LET'S LOOK AT THE EDITOR 
1 * THIS IS A PROGRAM 
2 * THAT WILL DEMONSTRATE 
3 * ALL OF THE TRSDOS-16 
4 * EDITOR'S COMMANDS 
BEGIN LD Ag, #TABLE *load start of table 
BNE DONE *if no match go to DONE 
MOV .D2,.D@ *otherwise move element number 
® 
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The Editor's position at this time is the last line of the 
program. To position the Editor to line 2, type: 


PO -5 <ENTER> 
The Editor displays: 


2 * THAT WILL DEMONSTRATE 


SEES MAEDA Oe OE EES ORAL ES 

To position the Editor to line number 1, type: 
- <ENTER> 

and the Editor now displays: 


1 * THIS IS A PROGRAM 
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PR lines 
prints lines on the printer. 


lines is optional. If you omit lines, the Editor prints 
only the current line. 


If lines include absolute line numbers, the Editor prints 
them also. 


Before printing, PRINT moves the paper to the TOP OF FORM. 


Examples 
PR 2 <ENTER> 

prints line 2 on bye pei nteee 
PR ALL <ENTER> 

prints the entire listing on the printer. 
PR <ENTER> 


prints the current line on the printer. 
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QU 
terminates the Editor and returns to TRSDOS-16. 


If you attempt to QUit the Editor without SAVEing the 
current work file, you'll see the prompt: 


**NO FILES SAVED** 
ee OULT EDITOR? Y OR N** 


This warns you that you haven't saved the file you were 
working on. ZTE you don"t want to SAVE 2t, type: 


Y <ENTER> 
The Editor then terminates and returns to TRSDOS-16 Ready. 


If you do not want to exit the Editor without SAVEing your 
program, type: 


N <ENTER> 
You will now see the last line, followed by the Editor's 
command prompt. 
Examples 

QU <ENTER> 


(if you have saved your file) terminates the Editor and 
displays: 


** EDITOR TERMINATED** 


TRSDOS=LO KReEAdy igi vee s 4 O66 oe Oe 6 Sa eS ow 6 Wie We es 
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RELABEL 
RE lines 


Sequentially reorders the local label numbers between two 
global label definition lines. (See the Assembler Reference 
Section for details on local and global labels.) 


If either of the lines you indicate does not contain a 
global label definition, the Assembler will use the next 
line which does contain one. 


When the Editor alters lines, it displays all altered 
lines followed by the last altered line. That is, it 
repeats the last line. 


Use this command only on source text that uses the local 
label format. 


Examples 


Type in the example program using local and global labels. 
(Be sure to first delete all lines currently in the Editor.) 


$1<TAB>DATAL<TAB>1@ <ENTER> 
GLOBAL ONE <ENTER> 
$7<TAB>BE<TAB>S5 <ENTER> 
$5<TAB>BL<TAB>$7 <ENTER> 
GLOBAL TWO <ENTER> 
SY<TAB>NOP <ENTER> 
<TAB>LDA<TAB>.A@,S1 <ENTER> 
GLOBAL THREE <ENTER> 

! <ENTER> 


(After typing in this program, SAVE it, DElete ALL lines in 
the work file, and then CONCATenate it to have the Editor 
give it line numbers.) When you LIst it, the program now 
appears as: 


18h DATAL 1g 

2 GLOBAL ONE 

3°57 BE 55 
A°$5 BLT $7 

5 GLOBAL TWO 

6 S$@ NOP 

7 LDA .AQ,S1 
8 GLOBAL THREE 
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The Editor would execute the following commands in these 
ways: 


RE1,8 <ENTER> 


causes the Editor to relabel all the local labels in the 
above program. 


(After executing each RElabel command, you'll have to first 
DElete all the contents of the work file, then 
re-CONCATenate the program to see the effect of each 
RELABLE. 

RE 2 <ENTER> 


The Editor does not relabel any lines. It returns **ITEM 
NOT FOUND** followed by the line that you specified. 


RE 1,2 <ENTER> 


No relabeling occurs. The Editor returns **ITEM NOT FOUND** 
followed by the last line you specified. 


RE 1-3 <ENTER> 

causes the Editor to relabel GLOBAL ONE's range only. 
RE 2,5 <ENTER> 

causes the Editor to relabel GLOBAL ONE's range only. 
RE 2-6 <ENTER> 


causes the Editor to relabel GLOBAL ONE's and GLOBAL TWO's 
ranges. 


RE: 3.7% <ENTER> 
causes the Editor to relabel GLOBAL TWO's range only. 
RE ALL <ENTER> 


causes the Editor to relabel each GLOBAL RANGE in the 
program. 


When you RELABEL all of the program, it should be: 
Ls. DATAL 19 
2 GLOBAL ONE 
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oF SL BE SZ 
4 $2 BLT Sh 
5 GLOBAL TWO 
6 $l NOP 
7 LDA AQ,S1 
8 GLOBAL THREE 
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SA (lines) filespec 
saves filespec to disk. 
lines is optional. If you omit it, the Editor saves all 


of the current program. 

If you do not specify filespec, the Editor saves the 
program under the most recently CONCATenated or SAVEd 
filespec. Before doing so, it displays the filename, 
followed by "CANCEL = 'X'". To cancel the SAve, type X 
<ENTER>; to continue the SAVE, press <ENTER>. 


Examples 


With the sample program -- SAMPLE2/PRO -- CONCATenated in 
the work file, type: 


SAVE SAMPLE2/PRO <ENTER> 


The Editor SAVEs the program to disk, writing over any 
existing file with the same name. 


To SAVE only the first two lines of the program, type: 
SA (1,2) SAMPLE2/PRO <ENTER> 
If you type: 
SA <ENTER> 
the Editor prompts you with: 
SAMPLE2/ PRO 
CANCEL = 'X' 


If you want to discontinue the SAVE, type X <ENTER>; if you 
want to continue the SAVE, press <ENTER>. 
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SEARCH 


SE (lines)delimiter string delimiterG 


causes the Editor to search for string within the range of 
lines. 


lines is optional. If omitted, the Editor SEarches the 
current line only. You must enclose lines in parentheses 
( ) e 


G is optional. When used, it tells the Editor to list all 
occurences of string within the range of lines. If not 
included, the Editor lists only the first occurrence of 


string. 


Examples 


CONCATenate SAMPLE2/PRO into the empty Editor (every line 
has an absolute line number), and type: 


SE (1-2)*LOOK* <ENTER> 
"*" 1s the delimiter. The Editor searches lines 1 and 2 for 
the string LOOK. Since you didn't specify G, the Editor 
displays only the first line containing LOOK. 

SE (ALL) *BNE*G <ENTER> 
The Editor searches all lines of the program for the string 


BNE and displays every line containing it followed by the 
current line. 
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STRING 


ST (lines)delimiter stringl delimiter string2 delimiter G 


searches lines of the program for stringl and replaces 
it with string2. 


lines is optional; if omitted, the current line is used. 
You must enclose lines with parentheses ( ). 


G is optional. When used, it tells the Editor to substitute 
stringl with string2 at every occurence of stringl within the 
range of lines. If you don't specify G, the Editor substitutes 
string2 for stringl at the first occurrence within the range of 
lines. 


stringl is optional. If you omit it, the Editor inserts 
string2 at the beginning of every line within the range of 
lines. 


string2 is optional. If you omit it, the Editor deletes 
stringl. 


Examples 


With SAMPLE2/PRO still CONCATenated in the Editor's work 
file, type: 


ST(1-4)/THIS/THAT/G <ENTER> 


n7" ie the delimiter.. ‘The Editor finds: all occurrences (G 
is specified) of the string THIS and substitutes each with 
THAT. 


By typing: 
ST (ALL)/THAT/THIS/ <ENTER> 


the Editor finds all occurrences of the string THAT and 
replaces it with THIS, and stops at the first occurrence (no 
G specified). 


ST/E// <ENTER> 


causes the Editor to search the current line for the string 
RP. Since the second string 1s empty, 1t deletes .E&. 
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TAB 


TA c,tabstopl,tabstop2,.... 


allows you to set tabs for use in the Insert mode (I? 
prompt). 


c¢ can be any character that you choose to represent the 
tab. (except blank or $). If you don't specify c, the 
Editor clears all tab stops. 


tabstopl, tabstop2, .... are the positions where you set 
the tabs stops. You can specify up to eight tab stops, 
separating each with a comma. The-first tab in a line is 


tabstopl, the second tabstop2, etc. 


If you specify only the tab character, the Editor keeps all 
previous tab stops. In this way, you can change the tab 
character without altering the actual tab stops. This is 
especially useful when c is a character used in the text 

of an insert. 


To set a tab (at the Editor's commmand mode -- C?), type TA 
followed by the tab character, a comma, then a string of tab 
Stops (column number where you want to place tabs). You can 
enter up to eight tabs. 


You can also use the <TAB> key instead of the TABS command. 
Its tabstops are preset to multiples of eight (i.e., 8, 16, 
24% 325% “OCS. Ds 


When you enter <TAB> in the Insert mode, it displays a ae 
character. In the Command mode, the Editor displays the 
actual tabbed spacing. 


Use the <TAB> key when you want the multiple of eight 


tabstops; otherwise set your own tabstops with the TAB 
command. 


When setting tab stops: 


ce If you don't specify any variables, tab stops are 
cleared. For example, TA <ENTER> clears all tab stops. 


Le If you specify only the tab character, the actual tab 
stops remain the same. 
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a The tab character can be any character except blank, §, 
or one included in the text. 
4. Remember where you set the tab stops because, when you 


use them in the Insert mode, the Editor does not 
display the actual tab spacing. 


on Always set the maximum number of tabs that you'll 
want to use. For example, if you only set three 
tabs with the TA command, you can only reference three 
in the Insert mode. If you reference more than you 


set, the Editor deletes any information following the 
extra tab(s). 


You can use a tab character at any time in the Insert mode. 
For example, set tabs at 19, 28, and 35, with a slash (/) as 
the tab character, by typing: 

TA. j/ ;10,20;30- <BNTERS 
Now you can use tabs in any lines you type in the Insert 
mode. To do so, simply type the slash (/) before the word 
or phrase you want tabbed. You can use as many tabs as you 
set with the TAb command. Type: 

BEGIN/LD/.A%,#TABLE/*load start of table <ENTER> 
Now the program line is set with tabs. Whenever the Editor 
displays this line, it does so with the contents of the line 
tabbed like this: 


BEGIN LD Ag, #TABLE *load start of table 


Examples: 
TA/ SS i243 <ENTERS 


Sets tabs at columns 5, 12, and 38. The tab character is 
the / (Slash). 


TA ? <ENTER> 


Changes the tab character to ? (question mark) and keeps re a 
previous tab stops (5,12, and 38) the same. 
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TA <ENTER> 


Clears all tabs. 
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CHAPTER 3/ THE ASSEMBLER-16 


The Assembler-16 assembles a source file into an 
intermediate, relocatable object code file. 


This Chapter explains how to operate the assembler. For 
information on the source format required by the Assembler, 
see Section II. 


THE ASSEMBLER COMMAND 


This command, typed at TRSDOS-16 Ready: 
ASM16 source filespec {options} comment 


loads the Assembler-16 and assembles the source filespec 
using the default options or the options you specify. 
(The options and default options are described below). 


If you omit the source filespec's extension and include 
the disk identifier (drive or disk name), the Assembler-16 
uses the disk identifier instead of the extension. 


If you omit the source filespec's extension and also omit 
the disk identifier, the Assembler-16 uses /SRC as the 
extension. 


You can use a source file produced by other editors, as 
well as the Assembler-16's Editor, provided it is in one of 
these formats: 


(1) variable length record (VLR) with one statement 
per record preceded by a byte count (this is what 
the Editor in this package produces) 

(2) ASCII stream with one byte per record (an LRL of 
one) and each line terminated by a carriage 
return byte. 

(3) fixed length record (FLR) with one statement per 
record. 


The optional comment allows you to document the assembly. 


If you use the comment, you must enclose the options in 
braces {}. Otherwise, the braces are not required. 
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ASSEMBLER OPTIONS 


You can specify the one letter options in one of four ways: 


option switches the option ON 
option=Y switches the option ON 
option=N Switches the option OFF 
option=drive Switches the option ON using 


the specified drive 


You can separate each option with a comma, a space, or 
nothing (not separate them at all). 


The options and their defaults (what the Assembler-16 uses 
if you omit the option) are: 

C (Current Record Count) 

Displays the number of the record currently being assembled. 
The default is C=N. 

E (Errors Only) 

Produces a listing of only the records which generate an 
error, along with any any object produced, and the error 
message. The default is E=N. 

K (Keep Work Files) 

Keeps the Assembler-16 from deleting the work files. (See 
the W switch for an explanation of the work files.) This 
speeds up multiple assemblies, since the Assembler-16 will 
not have to create work files over and over again. The 
default is K=N. 

L (Listing File) 

Creates a listing disk file using the same filename as the 


source, with the extension /LST. The default is L=N. 


O (Object File) 
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Generates an object file using the same filename as the 
source, with the extension /OBJ. The default is O=Y. 


P (Print Listing) 


Prints the listing on the printer. The default is P=N. 


S (Short Listing) 


Truncates listing if the source is too long for a line (as 
opposed to wrapping-around). The default is S=N. 


T (Terminal Listing) 


Prints the listing on the video display terminal. The 
default is T=Y. 


U (Uppercase Conversion) 


Converts lowercase letters to uppercase letters. This is 
useful for printers without lowercase. The source remains 
unchanged. The default is U=N. 


W (Work File Specification) 


Allows you to specify which drive the Assembler-16 should 
use for its work files. The default is W=@. W=N is not 
allowed. 


To save memory, the Assembler-16 creates two work files 
during the assembly for temporary storage. It names the 
files: 


ASMS$PPp/WRK 
ASMP SO Pp/WRK 


(op is the partition number for multi-tasking environments. 
Multi-tasking will be available in a future release of 
TRSDOS-16. In a single-tasking environment, p=l.) 


The Assembler-16 stores this file in your primary drive 
(unless you use W=drive.) When it finishes the assembly, 
it deletes the work files (unless you use K=N). 


® 
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EXAMPLE ASSEMBLER COMMAND 
This command, typed at TRSDOS-16 Ready: 
ASM16 FRED {C=Y,L,P,U,W=4,K} <ENTER> 


causes the Assembler-16 to assemble the source file named 
FRED/SRC and: | 
. display a current record count on the screen (C=Y) 
. generate a listing file named FRED/LST (L) 
. generate an an object file named FRED/OBJ (the 
default of O is O=Y) 
. print the listing on the printer in all uppercase 
(P,U) 
. store the work files on drive 4 (W=4) 
. retain (not delete) the work files (K) 


THE ASSEMBLER LISTING 


1. Side-by-Side Listing Format 


The side-by-side listing starts on a new page. These are 
two examples of it: 


Example 1: 


8234C OME12ZF 43F8 743 * LDA Al, /MIT25: LABEL4 
G6E4+ 


Example 2: 


699 099586 221¢ LDL peel eS 
BPBPIBS3 

The meaning of the examples is as follows: 

Line l 

columns 1-4 contains the source file line number in 
decimal notation (Example 1 is line 8234; 
Example 2 is line 699) 

column 5 tells whether the line is from the primary 


source filespec or a file which was 
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copied into it. (See the COPY directive 
in Chapter 9): 
. a blank space indicates the line 
is from the primary file (Example 2) 
. the characters A-I indicate the line 
was copied. (Example 1 indicates 
the line was part of "Cc", the third 
file copied into the program.) 


column 7-12 contains the hexadecimal memory address 
where the operation word is stored. 
(Example 1 indicates the LDA instruction 
is at H'E12F; Example 2 
indicates LDL is at H'@586.) 


column 14-17 contains the hexadecimal operation word. 
(The lines immediately below it reflect the 
extensions.) (Example 1 indicates the 
operation word for LDA is 43F8; Example 2 
indicates LDL is 227C) 


columns 19-22 tells where the symbol used in the line (if 
any) was defined. (Example 1 indicates 
MIT25 LABEL4 was defined in line 743.) 


column 23 tells whether the symbol used in this line 
is from the primary file or copied. 

. a blank space indicates it was from 
the primary file (Examples 1 and 2 
both contain blank spaces in this 
column) 

. the letters A-I indicate the symbol 
was from a copied file. 


column 24 tells if the symbol used in the line is 
a backwards reference (defined in a previous 
line): 


, ah asterisk (*) indicates it 1s a 
backwards reference 
. a blank space indicates it is a 
forwards reference 
(Example 1 indicates MIT25 LABEL4 was 
defined in a previous line.) 


column 26-end is the source line, printed with no reformatting. 
If the source line is long, the excess is 
printed right justified on the following line. 
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Line 2 


columns 1§-17 is the extension of the operation word, 
right justified (Example 1 indicates the 
extension for the instruction is §6E4; 
Example 2 indicates a long extension of 


PIBOOO G3.) 


column 18 is the relocation type of the symbol used in 
the line (if any): 
- a period (.) indicates it is external 
(defined by DEF) 
a plus sign (+) indicates it is relocatable 
(defined in an RSECT) 
- a blank space indicates it is absolute 
(defined in an ASECT) 
(Example 1 indicates the symbol MIT25 LABEL4 is 
relocatable; Example 2 does not contain a symbol) 
see Chapter 9 for an explanation of the DEF, 
ROECT;: ana ASEC? directives. ) 


The Assembler-16 may print line 2 one to four times, depending on how 
many extensions the operation word uses. 


| | 
2. Error/Warning Messages 
The error and warning listing begins immediately after the 
Side-by-side listing. These are examples of it: 
Example ae 
2 PPILGH PUPAPooD 1 LOAD ‘ sDLy #32 
*** ERROR *** 1] UNKNOWN OPCODE 
*** ERROR *** 1] ILLEGAL STATEMENT 
Example 2: 
3 OPIIG4 383C LD sBi YZ, $32 
B929 
*** ERROR *** REGISTER SYMBOL REQUIRED B1XYZ 
** WARNING ** WORD LENGTH ASSUMED 
Example 3: 
WwW 
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4 PPGFHS S256 LD <DL ye #352 


** WARNING ** 


DP29 


WORD LENGTH ASSUMED 


The meaning of each line is as follows: 


Line l 


Line 2 


Line 3 


column 1-13 


column 15-16 


columns 


18-end 


is the line containing the error 


indicates with a dollar sign ($) the position 
of the errors or warnings. The Assembler-16 
uses this notation only where it is helpful. 


is the error message. Line 3 is repeated for 
each error in the source line. This is the 
meaning of each column in line 3: 


tells the type of message: 
***k ERROR *** (this causes the program not 
to assemble properly) 
** WARNING ** (this warns you that the 
Assembler-16 might not be interpreting 
your instruction as you want it to) 


identifies which $ character the error message 

is referencing (Both messages in Example 1 indicate 
that they are referencing the first -- actually 

the only -- $ character ) 


contains the error/warning message, followed by 
a blank space, followed by the associated symbol 
(if any). If the symbol is longer than space 
permits, it is truncated. 


List of Errors and Warnings 


CONSTANT OUT OF RANGE 


ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
ILLEGAL 
MISSING 


COPY FILE NOT FOUND 


BINARY CONSTANT FORM FIELDS SIZE ERROR 

COPY STATEMENT ILLEGAL ORG EXPRESSION 

EXPRESSION INCORRECT NUMBER OF EXPRESSIONS 
FORMAL INDEXING NOT ALLOWED 

HEX CONSTANT INVALID LOCAL 

LOCAL LOCAL LABEL NOT ALLOWED 

OCTAL CONSTANT NESTED COPY NOT ALLOWED 

STRING DELIMITER OPERAND INCOMPATIBLE WITH INSTRUCTION 
SYMBOL REGISTER SYMBOL REQUIRED 

COMMA STATEMENT IGNORED 
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MISSING COMMENT SEPARATOR 
MISSING SEPARATOR 

SYMBOL REQUIRED 

UNKNOWN OP CODE 

MISSING RIGHT PAREN 
MISSING STRING TERMINATOR 
PACKED STRING NOT ALLOWED 
GLOBAL SYMBOL REQUIRED 
INVALID FORMAL REFERENCE 
INVALID GLOBAL SYMBOL 
LOCAL MULTIPLY DEFINED 
LOCAL UNDEFINED 

SYMBOL MULTIPLY DEFINED 
SYMBOL UNDEFINED: 


ABSOLUTE EXPRESSION REQUIRED 


ADDRESS REGISTER REQUIRED 


3. Cross Reference Listing 


TRS-8 
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Ww 
SYMBOL NOT POP 
TOO MANY COPY STATEMENTS 
USE OF ILLEGAL FORM SYMBOL 
VALUE NOT RELATIVE TO CURRENT PSECT 
VALUE OUT OF RANGE 
VALUE TRUNCATED 
BIT NUMBER OUT OF RANGE 
SHIFT VALUE OUT OF RANGE 
SMALLER LENGTH ATTRIBUTE ASSUMED 
WORD LENGTH ASSUMED 
DIVISION BY ZERO 
ILLEGAL STATEMENT 
REPEATED RLIST ELEMENT - IGNORED 
INCORRECT NUMBER OF OPERANDS 
DSECT SYMBOL REQUIRED 
RSECT SYMBOL REQUIRED 


The cross reference listing starts on a new page. This is an 


example of it: 


LABELSCANHAVES INGLES PACES BUTDONTSHOWTHEM 
331 /MOV 336 /LD 
349 /LDL 343 /ADD 344 /LD 
376.7 STS 


PPGIP3G2 L+ 399C | 
337 /STP 338 /xCay 
356 /MOV 


The meaning of it is as follows: 


Line l 


columns 1-45 


is the first 45 nonblank characters of the 


symbol, with trailing blanks. 


column 56 is the length attribute of the symbol: 
L = Long 
W = Word 
B = Byte 
U = Undefined 


column 57 indicates where the symbol's relocation type: 
blank space = absolute (defined in a program 
section initialized by the ASECT directive) 
+ = relocatable (defined in a program 
section introduced by the RSECT directive) 
- = external (declared by the DEF directive) 


(If the program contains none of the above 
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directives, the Assembler-16 treats all the 
symbols as absolute.) 


columns 59-62 contains the source line number where the symbol 
is defined (**** indicates the symbol's undefined. ) 


column 63 tells whether the symbol is from the primary 
source filespec or a copied file: 
blank space = primary file 
A-I = copied file 


Lines 2-n 


columns 39-33 contains the source line number where 
the symbol is referenced. 


column 34 tells whether that line is from a primary 
or copied file: 
blank space = primary file 
A-I = copied file 


columns 35-4@ contains the source line's instruction 
preceded by a slash (/) 


The Assembler-16 lists line 2 as many times as there are 
references to the symbol. If there are no references, the 
Assembler-16 does not list line 2. Columns 39-41 are repeated 
across the entire width of the page. 

4, Statistics Listing 


The statistics listing is the final page of the listing. It 
lists the total ERROR and WARNING messages (in decimal notation). 


Example: 


STATISTICS OF THIS ASSEMBLY 


TOTAL NUMBER OF ERRORS 6 
TOTAL NUMBER OF WARNINGS 8 
® 
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CHAPTER 4/ THE LINKER 


The Linker (LINK16) links one or more "intermediate" files 
into an absolute program that the 6899M can execute. It 
does this in one pass. 


In addition, the Linker can load multiple object files, 
resolve undefined external references between the modules, 
and produce a single program file. 


PREPARING A LINKER CONTROL FILE 


Before using the Linker, you must prepare a Linker control 
Pale bys 


1. Creating an object file, and then 
2. Creating the control file 


1. Creating an Object File 


The object file is a file of intermediate, relocatable 
object code. You will normally use the Assembler-16 to 
create it. 


You can also create it with another assembler or compiler 
provided it produces the format required by the Linker. 
Appendix A describes the format. 


2. Creating the Control File 


The control file is a file of linker directives. You will 
normally use the Editor, as demonstrated in Chapter 1 to 
create it. 


You can also use other editors to create the file, provided 
it is in the format required by the Linker: 


(1) variable length record (VLR) with each record 
preceded by a byte count (this is what the Editor 
in this package produces. ) 

(2) ASCII stream with one byte per record (an LRL 
of one) and each line terminated by a carriage 
return byte. 
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(3) fixed length record (FLR) with one record per 
statement. 

The directives you can use in creating this file are: 
END 

END 
ends the control file. If the Linker reaches the end of the 
file and does not encounter an END directive, it 
automatically supplies one. 
Example: 

END 
tells the Linker to stop reading the control file, finish 
producing the absolute program file, and return to 
TRSDOS-16 Ready. 
INCLUDE 

INCLUDE object filespec wy 
inputs the object filespec and links it to the existing 
program. 
If you omit the object filespec's extension, the Linker 
appends the extension /OBJ. However, if you omit the 
extension and include the drive, the Linker treats the drive 
as the extension. 
Example: 

INCLUDE FILEL 
causes the Linker to load FILE1/OBJ and link it to the 
current program. 

INCLUDE FILE1:2 
causes the Linker to load FILE1/:2 and link it to the 
CUrFent: program, 
ORIGIN 

| : 
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ORIGIN address 
forces the next INCLUDEd filespec to be loaded beginning at 
the specified address. The Linker assumes this address 
is decimal unless it has either a leading 'O' or '>', both 
of which imply hexadecimal. 
The Linker will not test for conflicts with previously 
loaded code. For example, if you specify the same ORIGIN 
address for two filespecs, the Linker will load one on top 
of the other without giving you a warning. 


If you omit ORIGIN, the Linker uses an originating address 


of OPPO. 
Examples: 
ORIGIN 599g 


tells the Linker to use decimal 599M as the originating 
address for the next INCLUDEd file. 


ORIGIN >19 9 


tells the Linker to originate the next file at hexadecimal 


1PPP. 


* 


Begins a comment line. The Linker will print it on the map, 
but otherwise ignore it. 


Example: 
*This 1S a comment 


is ignored by the Linker. 


THE LINKER COMMAND 


This command, typed at TRSDOS-16 Ready: 
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LINK16 control filespec {options} comment 


loads the Linker, executes the directives in the control 
filespec, and produces an absolute program file. The 
absolute program file will have the same name as the 
control filespec, minus the extension. 


If you omit the control filespec's extension, the Linker 
appends the extension /CTL. However, if you omit the 
extension and include the drive, the Linker treats the drive 
as the extension. 


LINKER OPTIONS 


As with the Assembler-16, you can specify the one letter 
options in one of four ways: 


option switches the option ON 
option=Y switches the option ON 
option=N switches the option OFF 
option=drive switches the option ON using 


the specified drive number 
(for the M and O options only) 


The options and their defaults are: 


L (Create Map File) 

Creates a file containing a Linker map on the drive 
specified. The Linker assigns this file the same filename 
as the source, with the extension /MAP. The default is MEN. 
O (Output Program File) 

Creates a final, executable program file on the drive 
specified. The default is O=Y. 


P (Print Linker Map on Printer) 


Prints the Linker map. The default is P=N. 
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T (Print Linker Map on Terminal) 


Prints the Linker on the video display terminal. The 
default is T=Y. 


EXAMPLE LINK 


This is an example of linking a control file named TEMP/CTL. 
The next section, "The Linker Map" will use it to 
demonstrate the the various maps the Linker outputs. 


TEMP/CTL (created with the Editor) contains these 
directives: 


*LINK OF TEMP/CTL 

INCLUDE TEMP/OBJ 

ORIGIN $299 

INCLUDE TEMPB/OBJ 

ORIGIN 95909 

INCLUDE TEMPC/OBJ 

INCLUBE THREE/OBJ 

END 
Note: The word INCLUBE (in the next to the last line) is 
intentionally misspelled. The section on "The Linker Map" 
uses this misspelling to demonstrate how the Linker outputs 
errors. 
This command, typed at TRSDOS-16 Ready: 

LINK16 TEMP {L=2,P,T=N} <ENTER> 


causes the Linker to link an absolute program, following the 
directives in TEMP/CTL, and: 


. create a map file on drive 2 named TEMP/MAP (M=2) 
. print the map on the printer (P) 
. not print the map on the video terminal (T=N) 
. create a program file named TEMP (O=Y is the 
default) 
THE LINKER MAP 


The Linker map consists of the following: 


Ls lanker -control Listing 
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2. allocation map 

3. definitions map 

4, undefined references map 
5. summary 


1. Linker Control Listing 


The Linker outputs the linker control listing first. It 


conta 
inter 


ins each directive from the control filespec 
spersed with error messages. 


The above example produces the following listing: 


GPPH1 
GI GP2 
LIPH3 
GIGP4 
GOBOS 
GIGPE 
QOVI7 


RKKEKK 


OOGGS 


KKEKK 


* LINK OF TEMP/CTL 

INCLUDE TEMP/OBJ 

ORIGIN 9299 

INCLUDE TEMPB/OBJ 

ORIGIN @599 

INCLUDE TEMPC/OBJ 

INCLUBE THREE/OBJ 

S$ - ILLEGAL COMMAND 

END 

WARNING - UNRESOLVED EXTERNAL REFERENCE AT @@@592 


The Linker prints error messages as it encounters them. 


There 


are three classes: 
ERRORS -- these are caused either by syntax errors 
in the control file or object code errors. (The 


above example has an ILLEGAL COMMAND error due to 
the misspelling of INCLUBE. ) 


WARNINGS -- these are to advise you that the Linker 
might be interpreting your file in a different way 
than you intended. (The warning in the above example 
is due to an undefined symbol, MYSTERY SYMBOLIC 

LABEL, which appears in the undefined references map.) 


FATAL -- these are caused by errors in the object 
code construction. You should never get one of these 
errors when using the Assembler-16. These errors will 


always cause the Linker to abort the linkage. Note 
that an error line may be printed immediately before 
the fatal diagnostic. 


Radie Shaek 


66 


ASSEMBLER-16 THE LINKER 


TRS-8O0 ° 


Note that the above example lists the comment, *LINK OF 
TEMP/CTL. However, this comment has no effect on the 
linkage. 

2. Allocation Map 


The allocation map describes where in memory the Linker has 
located the INCLUDEd object files (modules). 


The above example produces this map: 


ALLOCATION MAP 


MODU LE NO ORIGIN LENGTH DATE CREATOR VER 
TEMP 1A OOGWGGO  ------ 11/24/81 ASM-16 1.94 
TEMPB 2A GBV200 ------ 11/24/81 ASM-16 1.@ 
TEMPC 3 GPA59P GPAIAFc 11/24/81 ASM-16 1.9 


The meaning of each column is as follows: 


MODULE -- the linked object filename. Only the filename 
(not the extension) is printed. 


NO -- the sequential order in which the modules are 
INCLUDEd. If the module is part of an ASECT (an 
absolute program section), this number is followed 
by the letter A. 


ORIGIN -- the memory address where the module is 
loaded. 
LENGTH -- the length of the module. The characters 


————-— ' in this column indicate the module is part 
of an ASECT and therefore the length is undefined. 


DATE -- the date the module was created. 


CREATOR -- the name of the assembler or compiler 
used to create the module. 


VER -- the version number of creator (1.@ for ASM-16). 


The above example indicates that the Linker included 
TEMP/OBJ, an absolute section, at address SdGgd. 
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TEMPB/OBJ and TEMPC/OBJ, both relocatable, are included at 
hexadecimal 299 and 59M. THREE/OBJ is not included, since 
the word INCLUBE was misspelled. 


3. Definition Map 


The definition map lists all the symbol defined as external 
by the DEF directive. 


The above example produces this map: 
DEFINITIONS 
SYMBOL VALUE PROG 
SYMBOLICLABEL OPAG52 1A 


The meaning of each column is as follows: 


SYMBOL -- the symbol itself. A maximum of 45 characters 
are printed. (This example contains only one.) 

VALUE -- the symbol's value 

PROG -- the module which defined the symbol. If the 


number is part of an ASECT, the letter A follows it. 


The Linker does not sort this map. It prints the symbols in 
the same order it encounters them. 


The Linker will not print this listing if there are no 
externally DEFined symbols. 


4. Undefined Reference Map 


This is a listing of all symbols referenced, but not 
defined. 


The above example produces: 
UNDEFINED REFERENCES 


SYMBOL 
MYSTERYSYMBOLICLABEL 
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indicating the file references only one undefined symbol -- 
MYSTERYSYMBOLICLABEL -- which was what caused the warning in 
the directive listing. 


The Linker prints the symbols in the same order it 
encounters them. It does not print the map if there are no 
undefined symbols. 


5. Summary 


This is the completion message, with a count of errors and 
warnings. 


The above example produces: 


RSECT LENGTH = SIOBGC 
PROGRAM ENTRY = (PPPOW 
PROGRAM LENGTH = £@M59C 


POS INDEPENDENT = NO 

LINK COMPLETE: @@@@1 ERRORS, O9@901 WARNINGS. 

which shows that @#9c is the length of TEMPC/OBJ, the one 
relocatable program section; $@9M is the originating address 
of the entire program; @5%9C is the length of the entire 
program; and the program is not position independent.. 


The Linker generated one error and one warning. 


ERROR MESSAGES 


This is a listing of the Linker error messages, divided into 
three groups: 


1. ERRORS 

2. WARNINGS 

3. FATAL 
ERRORS 


These messages alert you that the program will not link 
properly. 


FILE UNAVAILABLE, CODE= error code 
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The file included in the control file cannot be accessed for 
the reason cited by the TRSDOS error code. 


For example: 
FILE UNAVAILABLE: 'filename', CODE = 24 
indicates TRSDOS error 24 (file not found). 


ILLEGAL COMMAND 
The directive is not one of those allowed by the Linker. 


SYNTAX ERROR 
The directive has not been typed correctively. 


WARNINGS 


These messages warn you that the Linker might be taking a 
different action than you intended. 


DOUBLE DEFINED RSECT 

The module has more than one RSECT (for example, a blank 
RSECT and a named RSECT). The Linker allows only one RSECT 
per module. 


DOUBLE DEFINED SYMBOL: 'symbol' 

The symbol enclosed in quotes is defined in two separate 
modules. The Linker uses the first definition it 
encounters. 


ERRORS GENERATED DURING ASSEMBLY 
There were errors generated during the assembly of the 
module. 


SIZE ERROR AT: absolute address 

An external will not fit into the field reserved. The 
Linker lists the absolute address of the modifiable part 
of the instruction generating the error. 


For example: 

SIZE ERROR AT: §@G92902 
might occur when address 20% of the module contains an 
instruction such as: 

LDW .DO, /external 
with the Linker evaluating 'external' as greater than H'FFFF 
(the maximum value that will fit into a word). 


To solve the problem, put a '.L' after the name of the 
external wherever it is referenced. For example: 
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LDW .DO, /external .L 
will never generate a SIZE ERROR. (However, it does cost an 
extra word of program storage over the previous example.) 


Note that the address associated with the size error does 

not indicate the address of the instruction. Instead, it 

indicates the address of the modifiable field (the address 
where the external will be loaded.) 


UNRESOLVED EXTERNAL REFERENCE ATs: absolute address 

The Linker did not find a definition (DEF) for an external 
reference (REF). The Linker lists the absolute address of 
the instruction generating the error. 


WARNINGS GENERATED DURING ASSEMBLY 
There were warnings generated during the assembly of the 
current module. 


FATAL 


These errors should NEVER occur in normal use of the Linker. 
The Linker detects these errors primarily to support 
development of compilers and assemblers. 


If one of these errors occurs while using the Assembler-l6, 
it should be considered a BUG and be reported. See also the 
OBJECT CODE DESCRIPTION section in this manual. 


Note that unless otherwise stated, these errors are FATAL. 
The Linker will abort with an error message. 


DOUBLY DEFINED SECTION LENGTH 
The Linker encountered two DEFINE SECTION LENGTH plexes in 
the object stream. 


END OF OBJECT ENCOUNTERED 

The object code stream was improperly terminated (no END OF 
OBJECT plex). This may be caused by terminating the 
assembler (with BREAK key) before normal completion. 


ILLEGAL POLISH EXPRESSION 

An object code expression was encountered that does not 
conform to the standards set forth in the object code 
description. 


MODULE HAS MORE THAN ONE PROCESSOR DEFINED 
The DEFINE PROCESSOR plex was encountered more than once. 
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UNDEFINED EXTERNAL SYMBOL 
A SYMBOL REFERENCE was made without that symbol previously 
being defined. 


UNDEFINED OPERATOR 
An invalid operator was encountered during expression 
evaluation. 


UNDEFINED POLISH COMMAND 
An invalid operand was encountered in expression 
evaluation. 


UNDEFINED RSECT SELECTED 
An attempt was made to select a section (RSECT) that was not 
previusly defined (opened). 


RSECT LENGTH UNDEFINED 
A define section length plex was not encountered in the 


object stream. This is only a warning (the linker does 
NOt apore). 
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CHAPTER 5/ THE DEBUGGER 
The Model 16 Debugger (DEBUG) allows you to: 


debug an existing 6899@ machine code program 
insert a 68999 machine code program into memory 


The way to start the Debugger depends on which you want to 
doy 


(DEBUG will not load if it is not included in a file named 
CONFIG16/SYS. See Appendix D if it does not load properly.) 


STARTING THE DEBUGGER 


To Debug an Existing Program... 
To debug an existing program, type (at TRSDOS-16 Ready): 
DEBUG ON <ENTER> 
which turns ON a switch causing the Debugger to activate. 
While this switch is ON, any program you load is loaded into 
the Debugger. (The Debugger remains dormant until you load 
a program, ) 
For example, with the DEBUG ON, type: 
SAMPLE <ENTER> 


which loads SAMPLE into the Debugger. The Debugger displays 
the Register Display and a # prompt. 


The # prompt indicates you are in the Debugger command mode 
and can enter any of the Debugger commands. Type: 


H <ENTER> 
for a menu of all the commands. 


To turn OFF the Debugger switch, type (at the Debugger # 
Prompc.) ¢ 


O <ENTER> 
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or (at the TRSDOS-16 Ready prompt): 


DEBUG OFF <ENTER> 


To Insert a New Program... 


To insert a new machine-code program with the Debugger, type 
(at TRSDOS-16 Ready): 


DEBUG <ENTER> 


which causes the Debugger to activate, displaying the 
Register Display and the # command prompt. 


To insert a program beginning at address 509%, type: 
C 5909 <ENTER> 


the Debugger displays address 599M (in parentheses and its 
contents. To enter the MOVW instruction, type: 


39BC <ENTER> 


and the Debugger inserts 3@BC, the operation word for this 
instruction, and waits for you to insert the next 
instruction. (See Chapter 8, "Instructions", for 
information on machine code operation words.) 


Type Q <ENTER> to return to the # prompt. Type Q <ENTER> 
again to exit the Debugger. 


REGISTER DISPLAY 


When you first start-up the Debugger, the Register Display 
appears on your screen. Certain Debugger commands will 
“call™ 1t. (Cause 2b tO appear again) or update it. 


This is an example Register Display: 
TRS-8@8 Model 16 DEBUG Version 3.9 
PC=~P0GG9R X=6 N=P Z=6 V=08 C=G IM=~ S=U 


A=PP8P18FE PP8PPA4H PPF8P1B4E PP8P1BEA PPGPPOPH BP8P14EE MG8P1886 
D POPGPGES POPGPIDD BOVOFFFF BPIPIOPD CUPPORO PUPEoROR LEREBOOD 
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Line 1 contains the contents of the PC (program counter 
register and and the value of the condition codes. Notice 
that the PC register is set to a "relative" address. (The 
character R indicates the address is relative.) 


TRSDOS-16 loads DEBUG in memory that is "invisible" to the 
user. Therefore, a program origin address of zero is 
actually a "relative zero". All addresses are relative to 
the end of TRSDOS-16 and DEBUG. (See Appendix B, "Memory 
Map. ) 


Line 2 contains the contents of each of the eight address 
registers. (column 1 is register A, column 2 is Al, etc.) 


Line 3 contains the contents of each of the eight data 
registers. 


(The Debugger uses the same register notations as the 
Assembler-16. See Section II for a listing of these 
notations.) 
You can display or change the contents of any of the 
registers. To do this, type the name of the register 
preceded by a period (.). 
For example, at the # prompt, type: 

-AQ <ENTER> 
and the Debugger displays the contents of register AQ. 
If you do not wish to change this, simply press <ENTER>. If 
you do wish to change it, type the new value and then press 
<ENTER>. 

DEBUGGER COMMANDS 


To execute a Debugger command, type the one-letter command 
followed by <ENTER>. 


Some of the commands allow you to specify parameters. You 
must type a blank space between the command and the 
parameter. 


The parameters you can specify are: 


-. value 
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- register (register direct) 
. address 
Specifying a value 
To specify a value, you can use: 
a number 
(must be hexadecimal ) 
- an ASCII character 
(must be enclosed in quotes) 


or an expression of values separated by these operators: 


~. addition (+) 
~. subtraction (-) 


For example, when using the Change command, it prompts you 
for a value. You could enter: 


2i21 <ENTER> 

to insert the hexadecimal value of 2121, 
"AB' <ENTER> 

to insert the ASCII codes for 'A' and 'B', or 
32+*A' <ENTER> 


to insert 32 plus the ASCII code for 'A', 


Specifying a register directly 

To specify a register directly, precede the register name 
with the character @. This indicates direct register 
addressing. (This is the opposite of the Assembler-16's use 
of the @ notation.) 

For example: 


D @Al <ENTER> 


displays the contents of register Al. (If Al contains 1111, 
the Debugger displays 1111.) 
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Specifying an address 
To specify an address, you can use: 


»- a value 
(as defined above) 
a indirect register, preceded by a period (.) 
(the Debugger interprets the period as indirect 
addressing.) 


For example: 
D 1990 <ENTER> 
displays the contents of address 199@. 
D .Al <ENTER> 
displays the contents of the address contained in register 


Al. (If Al contains 1111, the Debugger displays the 
contents of address 11lll.) 


D 1999+59 
displays the contents of address 1959. 
When you specify an address, the Debugger assumes you mean 
an address relative to base zero. You can change this 
assumption by changing the value of the displacement 
register (with the R command), and then specifying the 
address with the letter 'R'. 


For example, if you set the displacement register to a 
relative 29000: 


D 1999R 
displays the contents of address 399%. The Debugger 
computes this address as the sum of 199M and 2999, the 
contents of the displacement register. 


D 1999+59R 


displays the contents of address 3959. 


The Debugger commands are: 
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A (Address Stop Command) 


A addressl,address2,mask 
A addressl,register,mask 


Executes the program being debugged until the contents of 
address2 or register is changed. 


You can specify the size of address2 or register with: 
/B (byte) 
/W (word) 
/L (long word) 


addressl is optional. If specified, execution begins at 
addressl. Otherwise, execution begins at the current 
address. 


mask is also optional. It allows you to mask address2 
Or FeEGLSter . 


Examples: 


A ,@A5 


executes the program from the current position until 
register A5 is changed. 


A ,@A5,FFQ9 


stops execution when the third and fourth bytes (specified 
by the mask) of register A5 is changed. 


A 599,1944/L 


executes the programming beginning at address $599 until the 
long word at 19744 is altered. 


B (Breakpoint Command) 


B breakpoint, address 


B breakpoint 
B breakpoint/ 


Allows you to: 
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. set up to eight breakpoint addresses 
. Gisplay the contents of a breakpoint 


. reset a breakpoint 


Be sure to set the breakpoint address at the beginning of an 
instruction -- never in the middle of an instruction. 


For example: 

B1,1990 <ENTER> 
sets 1998 as the first breakpoint address. When you execute 
your program (with the G command), it will stop executing 
when it reaches address 1909. 

B 1 <ENTER> 
displays breakpoint 1. You can enter a new value or simply 
press <ENTER>. (******** means the breakpoint is not set.) 
Both the relative and non-relative values are displayed. 

B 1/ <ENTER> 
resets breakpoint 1 (to 32 bit-1). 

B <ENTER> 


displays all the breakpoints currently set. 
C (Change Command) 


C address 
Enters the "change mode" displaying the contents of the 
specified address (in parenthesis), followed by its 
contents. 


Type value <ENTER> to insert a new value for that address. 
(value can be one to four bytes.) 


Type / <ENTER> to see the contents of that address again. 


Press <ENTER> to see the contents of the next address (the 
next memory word). 
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Press <CTRL> <9> <ENTER> to see the contents of the previous 
word (the previous memory word). 


Type Q <ENTER> to exit the "change mode". 
Example: 
C FR6A 
displays the contents of address FM6A. 
307A <ENTER> 
changes the contents of that address to 3@7A. 
/ <ENTER> 
displays the address with its new contents. 
<ENTER> 
displays the next address. 
<CTRLS <9> <ENTER> 
displays the previous address. 
Q <ENTER> 


exits the change mode. 


D (Display Command) 


D address or register,address or register,address or 
register 


calls the Register Display and displays the contents of up 
to three address or registers in the top right-hand corner. 


The Debugger will continually update this display as you 
debug the program. 
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D A4QVB, .A5, @A4 
displays the Register Display with the contents of address 
A4QVB, the address specified by register A5, and the contents 
of register A4. 


D @A2 <ENTER> 


displays the contents of register A2. 


E (Erase Breakpoints Command) 


E 


Erases the breakpoints. 


G (Go Command) 


G address 


executes the program beginning at the specified address. 
Execution continues until the Debugger reaches a breakpoint 
(set with the B command) or the end of the program. 


address is optional. If omitted, execution begins at the 
current address. 


Example: 

G 492B <ENTER> 
executes the program being debugged at address §49%2B and 
continues until the Debugger encounters a breakpoint or the 
end of the program. 
H (Help Command) 


H 


Displays all the Debugger commands. 
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N (Next Instruction Command) 
N 


executes the next instruction and then calls the Register 
Display. 


After entering the N command, simply press <ENTER> to 
execute another "next" instruction. Executing any other 
command exits this "next instruction execution mode". 
If the next instruction is a call to a subroutine, the 
Debugger executes the entire subroutine. (Use the S command 
to single step through the subroutine.) 
Example: 

N 
executes the next instruction in the program currently being 
debugged. 
O (Quit Debug with DEBUG OFF Command) 

O 


Turns DEBUG OFF and exits the Debugger. The next program 
will load into the normal TRSDOS-16 Ready. 


Q (Quit Debug with DEBUG ON Command) 


Q 


Exits the Debugger leaving DEBUG ON. The next program will 
load into the Debugger. 


R (Relative Addressing Command) 
R value 


displays and changes (if you specify value) or displays 
and allows you to change (if you omit value) the contents 
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of the displacement register. At start-up, the value of 
the displacement register is zero. 


The R command helps in debugging relocatable program 
sections. By specifying an address as Relative, the 
Debugger will add to this address the value of the 
displacement register. 
Examples: 

R <ENTER> 
displays the value in the displacement register. Press 
<ENTER> to leave it unchanged. Enter a new value to 
change it. For example: 

1908 <ENTER> 
causes hexadecimal 109% to be the new value of the 
displacement register. If you specify a relative address, 
such as: 

G 2@99R <ENTER> 
the Debugger will interpret this as: 

2098 + 10900 (the value in the displacement register) 


causing the Debugger to begin program execution at address 


3099. 

R 3333 <ENTER> 
causes hexadecimal 3333 to be the new value in the displacement 
register. 


S (Step Command) 


S 
executes the next instruction and calls the Register Display. 


The S command is the same as N, except S will single step 
through a subroutine. 
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AS with the N command, press <ENTER> to execute the next 
instruction. To exit the "single stepping mode", enter a new 
command. 


Example: 
S <ENTER> 


executes the next instruction in the program being debugged. 


V (View Command) 


V addressl,value 
V addressl,address2 


displays the contents of the addresses beginning with 
addressl (or the current address) and continuing for the 
number of bytes specified by value. 


If the value is larger than addressl, the Debugger 
interprets it as address2. In this case it displays the 
address beginning with addressl and ending with 
address2. 


If you specify only addressl, the Debugger displays 16 
bytes beginning with addressl. 


Examples: 
V 50999,190 <ENTER> 

displays 19% bytes of memory starting at address 59@@. 
V 5989 ,55 90 


displays memory starting at address 59@@ through address 
5590. 


V 50998 <ENTER> 
displays 16 bytes of memory starting at address 599@. 
V <ENTER> 


displays the next 16 bytes of memory. 
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V .Ag 


displays 16 bytes of memory starting with the address 
specified by the contents of register AQ. 
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The Assembler-16 contains an easy-to-use set of assembly 
language mnemonics for developing Motorola MC68#%% programs 
on the TRS-8% Model 16. 


Please note that the Assembler-16 mnemonics are not the same 
as the Motorola mnemonics. This is due to a major effort 
among programming and engineering organizations to 
standardize mnemonics. 


Since the Assembler-16 mnemonics and notations are different 
from Motorola's, you will need to use this Reference Guide 
to learn the Assembler-16 ones. 


However, you will probably find it helpful to use these 
books to understand the logic of the 689@@ Microprocessor: 


MC680@8: 16-BIT MICROPROCESSOR User's Manual, 
Motorola Incorporated, 1989 


The 68990: Principles and Programming, by Leo J. 
Scanlon: Howard W. Sams & Co., Inc., 
Indianapolis, Indiana, 198l. 
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KEY TO NOTATION 


The following notation conventions are used in this 


section: 


] 


= Wm 


Cr 
oe 
ue) 


the item within is optional. 

a byte length string (8 bits). 

a word length string (16 bits). 

a long word length string (32 bits). 

an undefined length string. 

an expression (described in chapter 2). 
in place of a blank space. 


The registers are represented as follows: 


Ad or Dd 


An 


As 


Au 


Dn 


Rn 


USP 


or 


or 


Ds 


Du 


an address or data register used as a 
destination operand. 


one of the eight address registers AQ-A7 (n 
specifies the register number). 


an address or data register used as a source 
operand. 


an address or data register used as an 
upper-bounds operand. 


one of the eight data registers D@-D7 (n 
specifies the register number). 


any data or address register (n specifies the 
register number). 


any register used as indexed register with 
optional .W (word) or .L (long) length 
specified. 

can. be either An.W, Anil, ‘Dn.W, or Dns bl. 


the stack pointer. 


the supervisor stack pointer register (SP in 
System Mode). 


the user stack pointer register (SP in the 
User Mode). 
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68990 ORGANIZATION 
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CHAPTER 6/ 68888 ORGANIZATION 


The 68898 contains eighteen registers: eight data 
registers, eight address registers, a program counter, and a 
status register. Both address and data registers can be 
used for word and long word arithmetic operations as well as 
for indexing. In addition, address registers can be used 
for indirect addressing; and data registers can be used for 
byte arithmetic operations. 


Data registers are 32 bits in size. Byte operands occupy 
the low order 8 bits, word operations the low order 16 bits, 
and long word operands the entire 32 bits. The least 
Significant bit is always labeled as zero. 


When one of the low order portions of a data register is 
used, only that low order portion is changed. The remaining 
high order position is not used or changed. 


Address registers are also 32 bits in size. However, they 
do not support byte-sized operands. Depending on the 
operation, either the low order 16 bits (word) or all 32 
bits (long word) are used. When the address register is a 
destination operand, the entire register is affected. [In 
word size operations, the operands are sign extended to 32 
bits before the operation is performed. 


The user stack pointer (USP) is another 32 bit register. 
While you are in the user mode, it provides the stack 
address in specific stack operations such as PUSHA and LINK. 
While in the supervisor mode, you can use it as an operand. 


The system stack pointer (SSP), also 32 bits, serves as 

the stack register while you are in the supervisor mode. 
While in the supervisor mode, you can use USP as an operand. 
You can never use SSP as an operand, nor can you use USP as 
an operand while in the user mode. 


Note: TRSDOS-16 does not allow you to get into the 
supervisor mode. 


Another 32 bit register is the program counter. It 
contains the memory address of the next sequential 
instruction to be executed. 
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The status register is a 16 bit register which contains 
certain system information as is illustrated below: 


ee pe Fs ag Ug aS Be J ee Se et 


Te Cs a Sr 61 AC 


In this diagram: 


T ~ contains the status of the trace mode (set when 
trace is on, cleared otherwise). 


S - reflects the current status of the CPU (set in 
Supervisor mode; cleared in user mode). 


I - contains the level of interrupt recognized by the 
CPU. 


Bits 8 through F make up the system byte of the status 
register. You can change these bytes only from the 
Supervisor mode. 


The least Significant byte (bits zero through seven) of the 
Status register is known as the "user byte" or the 
"condition code register" (CCR). You can address this 

byte from either the user or supervisor mode. The CCR 
contains information pertaining to the actions of the 
CULrent instruction... The bits. im: the CCrR ares 


xX - The eXtend bit is set when an instruction (like 
ADD) causes a carry at the most significant bit. 


N = The Negative bit is set when an operation 
results in a negative number (i.e., the most 
Significant bit of the operand is set in an 
arithmetic operation). 


Z ~ The Zero bit is set when an operation results in 
a zero value. 


V _ The oVerflow bit is set when an operation causes 
overflow of the operand (i.e., the resulting 
number is too big for the size of the operand. 


C= The Carry bit is set when an instruction (like 
ADD) causes a carry at the most significant bit. 
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Note: The carry and extend bits are set together during 
most operations. 
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MEMORY ORGANIZATION 


With the 689% processor, data can be accessed by using byte 
(8 bits), word (16 bits), or long word (32 bits) operations. 
All words and long words begin on even-numbered addresses. 


The most significant byte is stored first and the least 
Significant byte is stored last: 


UO: 3S) ee ML Le oe ‘ie ae ae eee ee eee 


word SPPIIP 
byte PPP 0OP byte SPP GH1 


word PPPPP2 
byte OOP GB2 byte S06 0H3 


word FFFFFE 
byte FFFFFE byte FFFFFF 


Long Word/Register/Address Organization - 32 Bits (MSB and 


LSB signify the most and least significant bits, 
respectively): 


EO 2 de ho 8 0) A OO 
high order 


low order 
high order 


low order 


Decimal Data - 2 binary coded decimal digits equals 1 byte 


(MSD and LSD signify the most and least significant bits, 
respectively): 
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tae 1 2 re ae 28 REC Se se 
BCD 9 BED.4 BCD zZ BCD. 3 
ere ey ae eres ere 


BCD: 6 BCD 7 
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INSTRUCTION FORMAT 


When the Assembler-16 translates the 68999 instructions into 
machine code, it arranges them so that the instruction word 
(16 bits) comes first, followed by any operands, which may 
include up to four more words. The result of this operation 
is stored in the destination. The source is the second 
operand. This is illustrated below: 


LS 34 13 12 2) eo oe 8 i ik ee ee ee ee ee 
operation word 
(first word specs operation & mode) 
immediate operand 
(if any, one or two words) 
source mode register extension 
(if any, one or two words) 
destination mode register extension 
(if any, one or two words) 


The typical format of the operation word follows, where mode 
and register are three bit fields. 
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ADDRESSING MODES 


The 68898 allows you to address data seven different ways: 


a Implicit - The operand is implied from the 
LNs truce 1On. 
Ae Register Direct - The operand or operands are ina 


data and/or address register. 


3% Address Register Indirect - The operand is ina 
memory location pointed to by an address register. 


4. Indirect with Indexing - The operand is in a memory 
location which is pointed to by the sum of an address 
register and an index register. 


oe Memory Direct (or Absolute) - The operand is ina 
memory location which is supplied by an expression. 


6. Program Relative - The operand is in a memory 
location which is offset from the PC by a given 
displacement. 

ts Immediate - The operand follows the instruction word. 
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Implicit Addressing 
Some instructions make implicit reference to the program 
counter (PC), the system stack pointer (SP), the supervisor 
stack pointer (SSP), the user stack pointer (USP), or the 
status register (SR). The table below provides a list of 
these instructions and the registers implied. 


INSTRUCTION IMPLIED REGISTER(S) 


branch conditional (Bcc), branch (BR) PC 


check register against bounds (CHK) SSP SR 
@ | cisneaaiviee ow ss sk 
Funiok my ge 
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Register Direct Modes 
The operand is in one of the 689@@ registers. So, it could 
be in either AQ-A7, D§-D7, CCR, SR, or USP (USP can only be 
used in the supervisor mode). 
Data Register Direct: .Dn 
The operand is in the specified data register. For example, 
CLRW . DP 
clears the least significant word in data register DO. 
The operand is a data register; length (1) is 1, 2, or 4 
bytes. 
31. g 


OPERAND (Dn) 


Address Register Direct: .An 


The operand is in the specified address register. For 
example, 


MOV L -AZ, .Al 
moves the long word contents of address register AZ to 


address register Al. 


The operand is an address register; length (1) is 2 or 4 
bytes (this addressing mode is valid for word and long 
operations only). 
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31 g 


OPERAND (An) 
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Memory Address Modes 
The operand is a memory location pointed to by the specific 
mode. 
Address Register Indirect: @An 


The operand is in a memory location pointed to by an address 
register. The addressing mode is used to address data. 


For example: 
CRLB CAG 


clears the byte at the memory location referenced by address 
register AQ. 


The operand is in a memory location; length is l, 2, or 4 
bytes. 


31 g 


ADDRESS REGISTER (An) 


MEMORY 


OPERAND 


Address Register Indirect Postincrement: @An+t 


The operand is a memory location pointed to by the contents 
of an address register (AO-A7). 
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When the operation is complete, the address register is 
incremented by one, two, or four. The increment size 
depends on whether the size of the operand is byte, word, or 
long word. If the address register is the stack pointer (SP 
or A7) and the operand is one byte, the address is 
incremented by two rather than one to keep the stack pointer 
on a word boundary. This addressing mode causes data mode 
memory accesses. 


For example: 
CLRW @AS+ 


clears the word at the memory location referenced by address 
register A@ and then increments Ag by 2. 


The operand is in a memory location; length is 1, 2, “Or 4 
bytes. 


31 g 


ADDRESS REGISTER (An) 


OPERAND LENGTH 
V 


MEMORY 


OPERAND 


Address Register Indirect Predecrement: -@An 
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The operand is in a memory location pointed to by the 
contents of an address register (AO-A7). 


Before the operand location is used it is decremented one, 
two, or four. The decrement size depends on whether the 
operand is size is byte, word, or long word. If the address 
register is the stack pointer and the operand size is byte, 
the address is decremented by two rather than by one to keep 
the stack pointer on a word boundary. This addressing mode 
causes data mode memory accesses. 


For example, 
CLRL -@aAg 


Decrements address register A@ by 4 and then clears the long 
word at the memory location referenced by AQ. 


The operand is in a memory location; length is 1, 2, or 4 
bytes. 


cal g 


ADDRESS REGISTER (An) 


OPERAND 
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Address Register Indirect 
with 16-bit Displacement: /exp@An 


The operand is a memory location pointed to by the contents 
of an address register plus a 16 bit expression which is 
sign extended to 32 bits by the processor. This addressing 
mode causes data made memory addresses. By branch 
instruction, it can refer to program locations. 


For example, 
CLR 8@AG 


clears the word at the memory location given by the sum of 
address register A@ and 8. 


The operand is a memory location; length is (1) = 1, 2, or 4 
bytes 


31 g 


ADDRESS REGISTER (An) 


V/ 


31 LO LS g 


| Ramee (cS CoN aie ey: oa 


| EXTENSION | EXPRESSION ‘aes + 


MEMORY 


OPERAND 
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Address Register Indirect Indexed 
with 8-bit Displacement: /exp@An(Ri) 


The operand is a memory location determined by the sum of 
the contents of the specified address register, an index 
register (either a double word or a sign-extended word) and 
the 8-bit expression which is sign extended to 32-bits by 
the processor. This mode causes data mode memory accesses, 
except when used with the BR and CALL instructions. 
For example, 

CLRW 5@AG (DP) 


clears the word at the memory location given by a sum of 
five, address register Af, and index register DQ. 


The operand is in a memory location; length is 1, 2, or 4 
bytes. 
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31 g 
MEMORY ADDRESS (An) 
See ieee 8 7 g 
SIGN 
EXTENSION EXPRESSION fe 
31 g 
LONG INDEX REGISTER 
OR---> + 
cr eS 16 15 i 
SIGN WORD 
EXTENSION INDEX 
fcr Wines | at ae REGISTER 
\ V 
) MEMORY 
| 
[cream | 
MD 


Radie Shaek 


8 


ASSEMBLER-16 : 68899 ORGANIZATION 
TRS-80 


Special Address Modes 


The operand is a memory location pointed to by an 
expression. 


Short Absolute: /exp [.W] 


The operand is a memory location pointed to by a 16 bit 
expression which is sign-extended to 32 bits by the 
processor. This addressing mode causes data mode memory 
accesses. With branch instructions, it can be used to 
reference program locations. 


For example, 

CLRW /SUM.W 
clears the word at the memory location given by SUM (the 
address of SUM has been assigned by a directive such as RES 


or DATA). 


The operand is in a memory location; length is 1, 2, or 4 
bytes. 


OPERAND 


Long Absolute: /exp[.L] 
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The operand is in a memory location pointed to by a 32 bit 
expression. The first word of the expression the high order 
part of the address. The second word of the expression is 
the low order part of the address. This addressing mode can 
be used to address data. With branch instructions it can be 
used to reference program locations. 


For example, 

CLRW /HEADING.L 
clears the word at the memory location given by HEADING (the 
address of HEADING has been assigned by a directive such as 


RES or DATA). 


The operand is in a memory location; length is l, 2, or 4. 
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FIRST 
EXPRESSION 


15 g 
SECOND 
EXPRESSION 


ou L615 4) 


CONCATENATION 


OF TWO WORDS 


V/ 


ME; MOR Y 
OPERAND 


Program Relative: exp@PC 


The operand is in a memory location pointed to by the sum of 
the program counter (PC) and a sign extended 16 bit 
expression. The value of the program counter is the 
address of the 16 bit displacement. This addressing mode 
causes program mode memory accesses. With the branch 
instruction it can be used to refer to program locations. 


For example, 


BR LOOP 


Radie Shaek 


114 


ASSEMBLER-16 680% ORGANIZATION 
TRS-80O 


branches to memory location LOOP. Note that the "@PC" is 
optional here. 


The operand is in a memory location; length is l, 2, or 4 
bytes. 


PROGRAM COUNTER 


31 g 


OPERAND 


Program Relative with Index: exp@PC(Ri) 

The operand is in a memory location pointed to by the sum of 
the program counter, the index register (Ri) and the 8-bit 
expression. Both the index register and the expression are 
sign-extended to 32 bits by the processor. The value in the 
program counter is the address of the displacement value. 
This addressing mode causes program mode memory references. 
For example, 


CLRW NUM@PC(DL) 
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~~ 
clears the word at the memory location given by the sum of 
NUM, the PC, and data'register Dl. 
The operand is in a memory location; length is 1, 2, or 4 
bytes. 
31 g 
PROGRAM COUNTER 
Ode ee ed ee = a g 
SIGN 
EXTENSION EXPRESSION + 
cpl g 
LONG INDEX REGISTER 
OR---> + 
ieee eee 1615 ~~ 
SIGN WORD 
EXTENSION INDEX 
ee ee REGISTER 
MEMORY 
| 
Immediate Data: #exp[.W] #exp[.L] 
Ww 
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The operand follows the instruction word in either one or 
two extension words, depending on the size of the operation: 


Byte Operation - The operand is the low order byte of 
the first extension word. 


Word Operation - The operand is the extension word. 

Long Operation - The operand is in the two extension words. 
The high order 16 bits are in the first 
extension word; the low order 16 bits are 
in the second extension word. 

For example, 

LDW .D¢,#H'112F 
loads the data register D@ with the immediate data H'112F. 
The operand is in the memory location immediately following 


the instruction; length is 1 or 2 bytes for 1 extension word 
and 4 bytes for 2 extension words. 
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CHAPTER 7/ THE ASSEMBLER 16 PROGRAM 


An assembly language source program can contain: 


- Labels 

- Instructions, Directives, or Programmed Operations 
- Operands 

- Comments 


These are organized into a program line in one of the 
following ways: 


[label ]bb[ INSTRUCTION] bb[operand(s) [1] ]bb[comment], 
[label ]bb[DIRECTIVE]bb[operand(s) [1]]bb[comment] or 


[label ]bb[PROGRAMMED OPERATION] bb[operand(s) [1]]bb[comment ] 


All fields are described as optional. A statement will have 
at least one field. Others will be optional depending on 
the statement. 


LABELS 


A label statement begins in column 1. It can be either 
global or local. A label must be followed by at least two 
spaces. 


Global - 


If the label is global (accessible by any main programs or 
subroutines), it can contain up to 45 characters. The first 
character must be alphabetic, the next 45 nonblank 
characters can be alphabetic, numeric, or an underline. No 
more than one consecutive blank space is permitted ina 
symbol. Single blanks are not significant. Two global 
labels which match the first 45 nonblank characters are the 
same to the Assembler-1lé. 


A global label can be the only entry on a source input line 
(this is known as a "hanging label"). Any reference to a 


hanging label will, in effect, be a reference to the 
statement following the hanging label. 
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Local - 


If the label is a local label (defined only within the 
current program), it is defined on the current location 
counter. Local labels consist of a dollar-sign character 
(S$) followed by a single integer. Local labels are used in 
the same way global labels are except that the scope is 
delimited by global labels. 


INSTRUCTIONS 
There are three types of instructions you can use: 
—- Mnemonics 
- Directives 


- Programed Operations 
Mnemonics 

The instruction (mnemonic) field can begin anywhere except 
in column one. If there is a label, two blanks must 
separate the label and instruction. The mnemonic field 
contains one of the allowed M689@@ operation mnemonics, 
followed by an operand length (1) indicator where needed. 
Length - 


With most instructions, you may specify the length of the 
operand on which it will act. This length (1) can be: 


B > pyte (8 bits) 
W - word (16 bits) 
L = Long word. (32. bits) 
For example: 
ADDB 
Signifies an ADD instruction of one byte (8 bits). 
If you do not specify a length, the Assembler-16 assumes a 
length. If the Assembler-16 cannot determine the length, it 


assumes word length and issues a warning to that effect. 


The following table illustrates the length assumed by the 
Assembler-16: 
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First Operand: B W L U 
B 

Second W 

Operand: L 
U 


You cannot specify length on unsized instructions or on 
instructions with only one size possibility. 


Directives 


The same basics that apply the instructions, apply to 
directives: 


The label if present, begins in column one with two 
blanks separating it from the directive. If there is 
no label, the directive can begin in column two. Some 
directives require either a label in the statement or 
a hanging label preceding the statement. 


The operand field syntax depends on the directive. The 
field begins two or more blank spaces beyond the end of 
the directive field. The field is terminated by two 
consecutive blanks not inside a quoted string. 


The optional comments' field is two blank spaces after 
the operand field. If there is no operand, it begins 
two positions after the directives field. 


Programed Operations 


The format for programmed operations is similar to that of 
directives: 


The programmed operation field contains a predefined 
program operator. It is defined in a user-defined 
opcode directive statement (in the source program) 
prior to its use as an opcode. This is done with the 
FORM directive (see Chapter 9). 


The operands are likewise predefined. 
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ww 
The label, if any, is defined at the current location 
counter. 
OPERANDS 
The optional operand field is separated from the mnemonic 
field by at least two blank spaces. The format of the 
operands depends upon the instruction; §, 1, 2, or more 
operands may be permitted. In certain addressing modes an 
operand length (1) can be optionally stipulated: 
~.W = word 
-L = long word 
General Operand Rules: 
ike Multiple operands are separated by a comma. 
pa Operands are checked by the Assembler-16 both by number 
and by addressing modes. 
3 Each operand must be valid for the instruction being 
performed. ad 
4. Single blank spaces are permitted within symbols and 
around operators and special characters. 
Bs Two or more blank spaces terminate the operand field 
and begin the comment field unless the blank spaces are 
within a quoted string. 
COMMENTS 
The optional comment field is separated from the previous 
field by at least two blanks. You cannot have a comment 
with a hanging label, nor may you have a comment on an END 
statement which does not have an entry point specified. A 
comment can occupy a whole line if there is an asterisk (*) 
in column one. 
: | 
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EXPRESSIONS 


Expressions occur as operands of machine instruction, 
assembler directive statements, or as programmed operation 
statements. An expression consists of one or more terms 
separated by optional operators. 


Each term in an expression may be: 


- a self-defining constant, 

- a symbol (local or global), 

- the program location counter character (*), or 
- a parenthesized expression. 


Constants may be decimal, hexadecimal, binary, octal, or 
character constants: 


Hexadecimal constants consist of a string of hex digits 
preceded by capital H quote (H'). 


Binary constants consist of a string of binary digits 
preceded by capital B quote (B'). 


Octal constants consist of a string of octal digits 
preceded by capital Q quote (Q'). 


A Character constant is a single character preceded by 
a quote (single or double). Packed character constants 
are not allowed. 


A local or global symbol represents an address. The 
Assembler-16 uses the symbol as a displacement to the PC 
register. 


The program counter (PC) results in a 32 bit displacement 
of the current statement. 


Expression evaluation is left to right with unary operator 
precedence. Parentheses may be used to change the order of 
expression evaluation. The operators used to build an 
expression are arithmetic or logical. 


Arithmetic operators act upon 32 bit signed integer 
quantities with negative numbers in twos complement format. 


+ is addition 
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- is unary minus or subtraction 
* is multiplication 
/ is signed division 


Only addition and subtraction are permitted using 
relocatable values. 


Logical operators act upon 32 bit binary unsigned numbers. 


-AND. is logical AND 
.XOR. is logical XOR 
sOR. ° Aue. Logical “OR 
sNOT. 1S. Logical Nor 
OHL. 18 shift dett logical 


where 
A.SHL.B 


shifts value A left B bits if B is positive and shifts value 
A right (-B) bits if B is negative. 


The Assembler-16 computes the size attribute of an 
expression from the size attribute of the terms of the 
expression. If exactly one term has a non-U size attribute, 
and all other terms have a U size attribute, then the 
expression inherits the non-U size attribute. If more than 
one term has a non-U size attribute, or if all terms have a 
U size attribute, then the expression is assigned a size 
attribute of U. 
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CHAPTER 8 


INSTRUCTIONS 
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CHAPTER 8/ INSTRUCTIONS 


Description 


In this chapter, each instruction is listed alphabetically. 
They are either listed individually or as part of an 
instruction group. 


Instruction Groups 


Some of the instructions fall into an instruction group. 
Each instruction within the group uses the same mnemonic, 
but the assembler-16 translates them into different machine 
codes. Preceding each instruction group is an overview 
giving the general function of the instruction group. 


Individual Instructions 


Some instructions have only one form. The function of 
individual instructions follows its syntax. 


Syntax 

The syntax consists of the mnemonic, the sizes allowed, and 
the addressing modes permitted. For example: 

LDA .Ad,/exp[.W or .L] Operand length(l) = L 


.Ad, [exp] @As[(R1i)] 
.Ad,exp[@PC[ (Ri) ]] 


The operand length is long (L); hence the mnemonic is LDA. 
The destination operand is an address register (.Ad), and 
the source operand may be either : 


1. an absolute short or long address ( "/exp[.W or 
re ae 


2. an indirectly derived address with optional 
displacement and index ( "[exp]@As[(Ri)]" ) 


3. a program relative address with optional index 
( “expt @€PCcl (Ria) 7" 9 
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Condition Codes 


After execution of the instruction, the status of the 
condition codes may change. This change is reflected under 
"Condition Codes". Each bit of the condition code register 
(CCR) may be listed as: 


- the bit is unaffected by the instruction 

@ the bit is cleared (reset to @) after the 
instruction is executed 

* the bit is either set to 1 or reset to @ based on 
the result of the operation 

U the bit is undefined for the operation 


For example: 


: ae ee eae a > 


This means that the X bit is not affected, the N and Z bits 
are set or cleared based on the result of the operation, and 
the V and C bits are always cleared. 


Instruction Fields 


The Assembler-16 translates the instruction into machine 
code. This machine code is referred to as the "Instruction 
Field". For example: 


15) SA se Wee SE as Sete ee eae os, ee 
BW Ml eive mode: — || regs. 


This is the instruction code for CLeaR. The top line refers 
to the bit number in the instruction word and the numbers in 
the second line refer to the actual bit. In this example, 
bits 8-15 contain the machine code for the CLeaR 
InNnStruction . 


The word "size" is listed under bits 6-7. This refers to 
the size of the operand to be CLeaRed (i.e.,byte, word, or 
long word). Under bits 3-5 is the word "mode". This refers 
to the addressing mode (e.g. direct address register, short 
address, etc.) The addressing mode takes three bits to 
describe, and these codes are listed on the next few pages. 
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Under bits @-2 is the word "register". This refers to the 
register number used by the instruction. This value also 
requires three bits and the codes for each register are 
listed on the following pages. For example, the 
LNnstruction: 
CLRL oDk 
generates the following code: 
bere ee ae a A a ce ag NB Sa a a 
ea ee a ee ei De ie 
(Note: The instruction codes may vary from the example 
above, depending on the number of operands, the sizes 
allowed, etc.) 
REGISTER/MODE CODES 
Reg ./mode 
Function Mnemonic Mode Code Reg. 
_ Code 
Data Register Direct = .Dn OOD n 
Address Register = .An OO1 n 
Address Register Indirect = @An 616 n 
Address Register Indirect = @Ant+ G11 n 
Postincrement 
Address Register Indirect = -@An 109 n 
Predecrement 
Address Register Indirect = exp@An 191 n 
16-bit displacement 
Address Register Indirect = exp@An(R1) 119 n 
Indexed with 8 bit displacement. 
This mode requires an additional one word extension: 
ee Sie ee ke I OO Ng op eee a ee ee 
[D/A] reg. [W/L | BO] S| Bl displacement value 
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Bie. ie. = 
= data register is index register 
1 = address register is index register 


Bits 14 through 12 - 
index register number 


Bit ll- 
@ = sign extended, low order integer 
register 
1 = long value in index register 


Absolute Short Address = /exp[.W] 
Absolute Long Address = /exp[.L] 
Program Relative = exp @PC 
Program Relative with = exp @PC(R 
Index 
This address mode requires one word of ex 
uel Soe ae 19 9 36. 
bal register [Wil #1 BLE displacement value 
Bit-i5 = 
= data register 
1 = address register 


Bits 14 through 12 - 
index register number 


Bit 1l - Index size 
®@ = sign extended, low order word in 
register: 
1 = long value in Index Register. 


Immediate Short = #exp[.W] 
Immediate Long = #exp[.L] 
Status Register = .SR 
Condition Code Register = .CCR 
® 
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3 2. 2k 


index 


0G 
ce 
Pa 
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O61 
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ADD 
ADD binary 


This instruction's general operation is: 
ADD[1] destination, source 


which adds the source to the destination. The result is 
stored in the destination. 


The Assembler-16 can interpret the binary ADD four different 
ways. From the operands used, it determines which 
instruction is to be executed. 


The Assembler-16 chooses which operation to use according to 
the following guidelines: 


ADD quick if the source is immediate 
(indicated by the # sign) and less 
than or equal to 8. 


ADD address if the destination is an address 
register and the source is other 
than immediate. 


ADD immediate if the source is immediate and 
greater than 8 (more than 3 bits). 


ADD data register for any other operations performed 
by the ADD instruction. A data 
register is always one of the 
operands. 
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ADD 
ADD quick/ ADD immediate 


ADD[1] -Dd, #exp[.W or .L] Operand length(1l): B WL 


-@Ad, #exp[.W or .L] 
@Ad+, #exp[.W or .L] 
/expl[.W or .L], #exp2[.W or .L] 
[expl]@Ax[(Ri)], #exp2[.W or .L] 


Ad, #exp[.W or .L] (Quick only (1)=W L only) 


Condition Codes: 


a a ee es & 


X - Set if carry occurred, cleared otherwise (Same as 
Parry (C) 2. 

N - Set if result is negative, cleared otherwise. 

Z - Set if result is zero, cleared otherwise. 

V - Set if overflow generated, cleared otherwise. 

C - Set if carry occurred, cleared otherwise. 


Condition codes are not affected if an addition to an 
address register is made. 
Examples: 
If DM is H'8P2A, then 
ADDW DP, #H' 79GB 
changes the contents of D@ to H'FP2A 
If DY contains H'OP2A, then 
ADDW DG, #4 


Changes the contents of D@ to H'PO2E. 


Instruction Fields for ADD quick 


to eS: ee Sc ee "ape ie "] 


19 Be op Ge en as a 

6 1 6 1] data | 6 [size] mode [| reg. | 
® 
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The data field contains bit data, with values 1-8. 
(9G@1-111 = 1-7 decimal {9M = 8 decimal) 


The size field contains the size of the operation. 
Tf the size field contains @@ it is a byte operation. 
If the size field contains 91 it is a word operation. 
If the size field contains 1@ it is a long word 
operation. 


The mode and register fields contain the address mode 

of the destination operand. Address register direct 
addressing is not permitted when the size of the instruction 
is byte length. If the size is word length and the 
destination is an address register, the source is sign 
extended to 32-bits. 


Instruction Fields for ADD immediate 


According to the size of the operation, the number of 
extensions for the immediate data vary (see data fields). 


TS) se Se eB ee 


or 
word data (16 bits) 
Or 


long word (32 bits including previous word) 


The size field contains the size of the operation. 
If the size field contains @@ it is a byte operation. 
If the size field contains 91 it is a word operation. 
Tf the size field contains 1@ it is a long word 
operation. 


The mode and register fields contain the address mode 
of destination operand. 


The data field contains the data immediately following 
the instruction: 
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If the size field contains @@, then the data is in the 
low order byte of the immediate word (8 bits). 

If the size field contains @1, then the data is in the 
entire immediate word (16 bits). 

If the size field contains 19, then the data is in the 
next two immediate words (32 bits). 
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ADD 
ADD address register 


ADD[1] .Ad, .As Operand Length(1):W,L 
-Ad, .DS 
-Ad, -@As 
-Ad, @As+ 
Ad, /exp[.W or .L] 
.Ad, [Lexp]@Ay[ (Ri) ] 
.Ad, exp[@PC[(Ri)]] 
Ad, #exp[.W or .L] (Add immediate only) 


Adds the source to the destination address register. 


Example: 
Tf A@® contains H'69@M and Al contains H'#@P1H, then 
ADDW fs ame 


changes the contents of Af to H'6919. 


Condition Codes: 


x IN 2 ov OG 


All of the flags are unaffected. 


Instruction Fields: 


io a a3 cr 1p 
ie eat See SOG Tae Te a 


The register field contains any address register; always 
the destination operand. 


The size field contains the size of the operand. 


If the size field contains @@1l it is a word operation. 
The source operand is sign-extended (See EXT) to fill 
32 bits of the address register. 
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If the size field contains 111 it is a long word 
operation. 


The mode and register fields contain the address mode 
of the source operand. 
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ADD 
ADD data register 


Operand length(1):B,W,L 

ADD[1] .Dd, .Ds 

-Dd, -@As 

-Dd, @As+ 

-Dd, /exp[.W or .L] 

~-Dd, [exp]@Ay[(R1) ] 

.Dd, exp[@PC[ (Ri) ]] 

~-Dd, .AS (Word and long word length only) 

-@Ad,.Ds 

@Ad+,.Ds 

/exp[.W or .L],.Ds 

[exp] @Ax[(R1i)],.Ds 


A data register is always one of the operands. 


Example: 
If D@ contains H'#143 and Dl contains H'#PP7, then 
ADDW 20. i: 


changes the contents of D@ to H'f14A. 


Condition Codes: 


» ae: ee | ee 


X - Set if carry occurred, cleared otherwise(same as 
CaEry (GC) 

N - Set if the result is negative, cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Set if overflow is generated, cleared otherwise. 

C - Set if carry occurred, cleared otherwise. 


Instruction Fields: 


Lt be + +s i ik 19 


A514 3} ree mode reg 
® 
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The register field contains the data register. 


The size/op field contains the size of the operation and 
the destination of the result. 


Byte Word Long Word Destination 
GPO G91 $18 data register 
189 191 119 second operand 


The mode and register fields contain the location of 
the second operand. 


If the second operand is the source operand and its 
size is one byte, the address register direct 
addressing mode is not permitted. 
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ADD binary with Carry 
ADDC[1] .Dd,.Ds Operand-length (1): B,W,L 


Adds the source and carry bit at the destination. The 
result is stored in the destination. 


Example: 


If D@ contains H'@5 and Dl contains H'@6, and the extend bit 
of the status register is set, then 


ADDCB Ba) prope Bey 


changes the contents of D@ to H'Q@C. 


Condition Codes: 


> Te eee cae eee = 


- Set if carry is generated, cleared otherwise. 

- Set if the result is negative, cleared otherwise. 
Cleared if the result is nonzero, unchanged otherwise. 
- Set if overflow is generated, cleared otherwise. 

- Set if carry is generated, cleared otherwise. 


QAaIn wz > 
i 


Instruction Fields: 


Gs ames eae es mes et ne OS a : ee ee eo ee ie ce ee a 
a a ae! reg(d) | 1 [size| S| Sir/m| regis) 
The register(d) field contains the destination register. 
If the R/M field is zero, register(d) is the data 
register. 


Tf the R/M field is one, register(d) is the address 
register in the predecrement addressing mode. 


If the size field contains 91 it is a word operation. 
Tf the size field contains 19 it is a long operation. 
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ww 


The R/M field contains the operand addressing mode. 
If the R/M field is @, the Operation is from data 
register to data register. 
If the R/M field is 1, the operation is from memory to 
memory. 


The register(s) field contains the source register. 
If the R/M field is Q, register(s) is the data 
register. 
If the R/M field is 1, register(s) is the address 
register in predecrement addressing mode, 


WwW 
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ADDD 
ADD Decimal(BCD) with extend 


ADDD .Dd, .Ds Operand length (1): B 
Adds the source and the extend bit to the destination and 


then stores it in the destination. Binary coded decimal 
arithmetic is used for the addition. 


Example: 


If D@ contains 6 and Dl contains 7, and the extend bit of 
the status register is set, then 


ADDD -D@,.D1 


changes the contents of D@ to 14. 


Condition Codes: 
~~ 


m Ne he Se © 


- Set if a carry (BCD) is generated, cleared otherwise. 

- Undefined. 

Cleared if the result is non-zero. Unchanged otherwise. 
- Undefined. 

-~ Set if a carry (decimal) generated. Cleared otherwise. 


oOCcn sa & 
i 


Instruction Fields: 


LS 2A Se wa ss Be OG Se ed 

Rt ob oe bee eeotd). a (Be (ee RM cred (s. 
If the R/M field is @, the operation is from data register 
to data register. 


If the R/M field is 1, the operation is from memory to 
memory. 


The register(s) field contains the source register. 
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The register(d) field contains the destination register. 
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AND 
logical AND 


The AND instruction can be interpreted by the Assembler-16 
two different ways. From the operands used, the 
Assembler-16 determines which instruction to use. 


AND[1] destination, source 


which ANDs the source with the destination. The result is 
stored in the destination. 


The Assembler-16 chooses which operation to use according to 
the following guidelines: 


AND immediate if the source is immediate 
(indicated by the # sign). 


AND data for any other operations 
performed by the AND 
instruction. A data register 
is always one of the operands. 


Condition Codes: (Identical for both operations) 


x Ns”.  ¥ 


C 


X - Not affected 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

Z- Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 
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AND 
logical AND immediate 


AND[1] -Dd, #exp[.W or .L] Operand length(1l): B,W,L 


-@Ax, #exp[.W or .L] 

@Ax+, #exp[.W or .L] 
/expl[.W or .L], #exp2[.W or .L] 
[expl1]@Ax[(Ri)], #exp2[.W or .L] 

-CCR, #exp[.W or .L] (1=W only) 


Example: 
If D@ contains H'4F, then 


ANDB .DO,#H' FP 


changes the contents of D@ to H'4Q. 


Instruction Fields: 


byte data (8 bits) 
word (16 bits) 


or 


Long word.132 Dies) 


The size field contains the size of the operation. 
If the size field contains @fM it is a byte operation. 
If the size field contains 91 it is a word Operation. 
If the size field contains 1 it is a long word 
operation. 


The register and mode fields contain the address mode 
of the destination operand 


The data field contains the data immediately following 
the instruction: 
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If the size field contains @@, the data is in the low 
order byte of the immediate word (8 bits). 

If the size field contains @1, the data is the entire 
immediate word (16 bits). 

Tf the size field contains 19%, the data is the next two 
immediate words (32 bits). 
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AND 
logical AND data 


AND[1] .Dd, .Ds Operand length(1):B,W,L 

~-Dd, -@Ay 

-Dd, @Ay+ 

-Dd, /exp[.W or .L] 

-Dd, [exp]@Ay[ (Ri) ] 

-Dd, exp[@PC[ (Ri) ]] 

-@An,.Ds 

@Ax+,.Ds 

/exp[.W or .L],.Ds 

[exp]@Ax[(Ri)],.Ds 


Example: 
If D@ contains H'FFOP FFPMP and Dl contains H'@OFF OOFF, then 


ANDL “DG; 421 


changes the contents of D@ to H'PHOD OPOG. 


Instruction Fields: 


PS es Sa A a 2 ee a ee 
1 i =f § | register | size/op| mode | reg. | 


The register field contains the data register. 


The size/op field contains the size of the operation and 
the destination of the result: 


Byte Word Long Word Destination 
GLO GO G19 data register 
1692 191 119 second operand 


The register and mode fields contain the location of 
the second operand. 
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Bcc 
Branch on condition 


Bec[1] exp[@PC] Operand length(1): B,W 


Tests a condition. If the condition is true, sets the 
program counter (PC) to the value of the operand. If the 
condition is false, program execution continues at the next 
instruction. 


Example: 


If the zero flag of the status register is set, and LOOP is 
a statement label somewhere in the program, then, 


BE LOOP 


transfers control of the program to the instruction at LOOP. 


Condition Codes: 


AON oe ON 


None of the flags are affected. 


Instruction Fields: 


Se Al 2h Seem A A Ge 


g 1 i g 8 bit displacement 
16 bit displacement (if 8 bit dislacement is Q) 


The 8 bit displacement field contains the two's 
complement integer which contains the relative distance (in 
bytes) between the current instruction address, plus 2, and 


the referenced instruction. 


The 16 bit displacement field allows larger 
displacement than 8-bits. It is used if the 8-bit field is 
equal to zero. 


The condition field is one of the following fourteen 
conditions: 
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@11ll BE - equal 
@119 BNE - not equal 
0191 BC - carry 
0198 BNC - no carry 


1918 BP - positive 
1911 BN - negative 
1@@1 BV - overflow 


1998 BNV - no overflow 

111@ BGT - greater than 

1199 BGE - greater than or equal 
1191 BLT - less than 

llll BLE - less than or equal 
0910 BH - higher than 

0911 BNH - not higher than 

0191 BLO - low 

0108 BHS - high, same 
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BR 
BRanch control addressing 


BR /exp Operand length(1): unsized 
[exp] @Ax[ (Ri) ] 
exp[@PC(Ri) ] 


The program execution branches to the address given by the 
operand. 


Example: 
If LOOP is a statement label somewhere in the program, then 
BR LOOP 


transfers control of the program to the instruction at LOOP. 


Condition Codes: 


xX ON 2. 


None of the flags are affected. 


Instruction Fields: 


ey cect Oe ee = ee ee ee: ea See oe es 


: a ee 
foe dO Wee SB A modes |. reg. 


The register and mode fields contain the address of 
the next instruction. 
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BRK 
BReak 


BRK #exp Operand length(l): Unsized 


Three operations are performed by this instruction: 


di The program counter is pushed into the supervisor 
stack. 

o- The status register is pushed into the supervisor 
stack. 

5% The vector number (#exp) is loaded into the program 
counter. 


This instruction initiates exception processing. The vector 
number is generated to reference the Break exception vector 
which is specified by the four low order bits of the 
instruction. Sixteen vectors are available. 

Example: 

If a supervisory call (SVC) has been set up, then 


BRK #9 


causes execution of that SVC. 


Condition Codes: 


eo Be ee 


None of the flags are affected. 


Instruction Fields: 


oa ae: Sea 3” 1g 6 ae ae ome 
Ss a a a 


The #exp field contains the number (break vector) to be 
loaded into the program counter. 
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BRKV 
BReaK on oVerflow 

BRKV Operand length(1): Unsized 
Initiates exception processing if the overflow condition is 
on (overflow(V) = 1). Generates the vector number to 
reference the overflow exception vector as follows: 

Program Counter (PC) --> Stack 

Status Register (SR) --> Stack 

Overflow Vector --> Program Counter (PC) 
No operation is performed if the overflow is off. Execution 
continues with the next instruction. (Notes You must sec 
the overflow vector using the SETTRP SVC before executing 
the exception.) 
Example: 
If the overflow bit of the status register is set, then 


BRKV 


initiates overflow exception processing. 


Condition Codes: 


XO. Ae 


None of the flags are affected. 


Instruction Fields: 


eS ba ee a SE a Be cB SO 
V4 1 g g 1 <a a Sees | es Ge aa 


Ww 
aa LO 
| 
SQ 
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CALL 
CALL general 


CALL /exp Operand length(l): Unsized 
[exp]@Ax[ (Ri) ] 
exp[@PC(Ri) ] 


Example: 


If SUB1 is the label of a subroutine somewhere in the 
program, then 


CALL SUBL 


transfers control of the program to the instruction at SUBI1. 


Condition Codes: 


Be Ne 


None of the flags are affected. 


Instruction Fields: 


BO ee ee ee OE Be og ae A. SD eg 


Pd de el La mode. | -red. 


The register and mode fields contain the address of 
the next instruction. 
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CHK 
CHecK against bounds 


CHK Di, +DD Operand Sizes : W 
-@Au, .Dn 
@Au+, .Dn 
/exp[.W or .L], .Dn 
[exp] @Ax[(Ri)], .Dn 
exp([@PC[(Ri)]], .Dn 
#exp[.W or .L], Dn 


Examines the content of the low order in the data register 
(Dn) and compares it to the upper bound operand. The upper 
bound is a two's complement integer. Exception processing 
is initiated if the data register is less than zero or 
greater than the upper bound operand. Generates the vector 
number to reference the CHK instruction exception vector. 
(Note: You must set the CHK vector with the SETTRP SVC 
before executing this statement.) 


Example: 


Tf DG contains H'#1GPG and Dl contains H'#1gl, then 
CHK eBay. DL 


initiates CHK exception processing. 


Condition Codes: 


5 ae» ey ieee eee 
Hee TL 


X - Not affected. 

N - Set if Dn is less than zero; cleared if Dn is greater 
than the; undefined otherwise. 

Z -—- Undefined. 

V - Undefined. 

C - Undefined. 


Instruction Fields: 


Radie Shaek 


| 


Lo 


ASSEMBLER-16 F INSTRUCTIONS 
TRS-80 


BO se! a ae ee, Oa i A ee 
Hi pf . ) | gata reg. |1 1 of |. mode. jf reg. | 
(upper bound) 


The data register contains the data register whose 
content is checked. 


The register and mode fields contain the upper bound 
operand word. 
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CLR 
CLeaR an operand 


CLR[1] .Dn Operand length(l): B,W,L 
-@An 
@An+ 
/exp[.W or .L] 
[exp]@An[ (Ri) ] 


Clears the operand to all zero bits. 


Example: 
If D@ contains H'#9P1, then 
CLRW .Dg 


changes the contents of D@ to H'PPOD. 


Condition Codes: 


Not affected. 
Always cleared. 
Always set. 
Always cleared. 
Always cleared. 


AGNAK 
nou nd te il 


Instruction Fields: 


Db Ate Oe oh I 28 Oe ie: 25 aed he) ee 
6 A. £ (£6 1 O [sizel— mode | reg. 


The register and mode fields contain the operand 
addressing mode. 


The size field contains the size of the operation: 
If the size field contains 9M it is a byte operation. 


If the size field contains §1 it is a word operation. 
Tf the size field contains 19 it is a long word 
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operation. 
CMP 
CoMPare 


This instruction's general operation is: 
CMP[1] Destination, Source 


where the source is subtracted from the destination and the 
condition codes (CCR) are set according to the results. The 
values of the operands are not changed. 


The compare instruction is interpreted by the Assembler-16 
as four different instructions. The Assembler-16 determines 
which is to be executed by the operands. 


The Assembler-16 chooses which operation to use according to 
the following guidelines: 


CMP immediate if the source is immediate 
(indicated by the # sign). 


CMP memory if both operands are addressed 
with the postincrement 
addressing mode. 


CMP address for any other compare 
operation where 
the destination is addressed 
using the address register 
direct mode. 


CMP data for any other compare 
operation where the 
destination is addressed using 
the data register direct mode. 


Condition Codes: are identical for all CMP operations. 


aA NN 4. -¥ 


X - Not affected. 
N - Set if the result is negative, cleared otherwise. 
Z- Set if th eresult is zero, cleared otherwise. 
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f 
V - Set if overflow is generated, cleared otherwise. 
C - Set if borrow is generated, cleared otherwise. 
L> 
ft’ 
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CMP 
CoMPare immediate 
CMP[1] -Dd, #exp[.W or .L] Operand length(l): B,W,L 


-@Ax, #exp[.W or .L] 
@Ax+, #exp[.W or .L] 
/expl[.W or .L], #exp2[.W or .L] 
[expl1]@Ax[(Ri)], #exp2[.W or .L] 
Example 
If D@®@ contains H'#P19, then 
CMPW .DM,#H'1GD 


sets the zero bit of the status register. 


Instruction Fields: 


LS i dS 2 PU es eB A Bs ES og 


Pie ase ee eee DYES Gata. to bles) 
word data (16 bits) 


OF 


long word data (32 bits, including previous word) 


The size field contains the size of the operation. 
If the size field is OM, it is a byte operation. 
If the size field is 91, it is a word operation. 
If the size field is 19, it is a long word operation. 


The register and mode fields contain the address mode 
of the destination operand. 


The data field contains the data immediately following 

the operation word. 
If the size field is 9M, the data is low order byte of 
the immediate word (8 bits). 
If the size field is 91, the data is the entire 
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immediate word (16 bits). 
If the size field is 18, the data is the next two 
immediate words (32 bits). 
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CMP 
CoMPare memory 


CMP[1] @Ad+, @As+ Operand length(1): B,W,L 


Example: 


If A@ points to memory address H'4@@@, which contains H'Q@Q@, 
and Al points to address H'4@@4, which contains H'@5 then 


CMPB @AG+,@Al+ 
sets the negative and carry bits of the status register and 
increments A@™ and Al by l. 
Instruction Fields: 


bor 6a LS) SPO A ee iG Be A ee 
a Rae ee 
The register(d) field contains the destination register. 
The register(s) field contains the source register. 
The size field contains the size of the operation. 
If the size field is @@, it is a byte operation. 


If the size field is @1l, it is a word operation. 
If the size field is 19, it is a long word operation. 
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tn 
CMP 
CoMPare address 
CMP[1] .Ad, .As Operand length(1): W, L 
Ad, .Ds 
Ad, -@As 
-Ad, @Ast 
Ad, /exp[.W or .L] 
-Ad, [exp]@AyI[ (Ri) ] 
.Ad, exp[@PC[(Ri)]] 
Ad, #exp 
Example: 
If A@ contains H'@POF FPPG and Al contains H'PPPF BPPP, then 
CMPL Ag,.Al 
clears the negative bit in the status register. 
eo Instruction Fields: 


150-14 18 IO a oo BG oe 8 de 
To. oS Ae Be Seg [gi zes. |: mode a), re. 


The register field contains the destination address 
register. 


The size field contains the the size of the operation 
“Tf the size field is @@1, it is a word operation. 
The source is Sign extended to a long operand and the 
operation is performed internally using all 32 bits. 
If the size field is @11, it is a long word operation. 


The register and mode fields contain the source 
address mode. 
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CMP 
CoMPare data 


CMP Operand Length(1): B,W,L 
CMP[1] ~-Dd, .Ds 

e Dd, -@As 

~-Dd, @As+ 


Dd, /exp [.W-or .L] 
-Dd, [exp]@Ay[(Ri)] 
-Dd, exp[@PC[(Ri)]] 
-Dd, As ([{1]=W, L only) 


Instruction Fields: 


Do 4 as ee Ps 0. BP ee OE Be 

ee oe req. | size | mode [| reg. | 
The register field contains the destination data 
register. 


The size field contains the size of the operation. 
If the size field is §9M, it is a byte operation. 
If the size field is @@1, it is a word operation. 
If the size field us 912, it is a: long word cperation:. 


The register and mode fields contain the source 
operand addressing mode. 
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DBcc 
test condition Decrement and Branch 


DBcc .Dx, exp[@PC] Operand length(1l): W 
A condition is tested. If the condition is determined to be 
true, no operation is performed. If the condition is false 
(not cc), the low order word (16 bits) of the data register 
is decremented. When false and the result is -l, then no 
other operation is performed (the program goes to the 
next instruction); if the result is anything besides -l, 
then the program counter is set to the value of the second 
operand (PC plus exp, where PC is the address of exp, the 
displacement word). 

Examples: 


If DM contains H'@2, the zero bit in the status register is 
set, and LOOP is a statement label, then 


DBNE .D@,LOOP 
changes the contents of D@ to H'@#l, and then transfers 
control of the program to the instruction at LOOP. 
If D@ contains H'@F1, the zero bit in the status register is 
clear, and LOOP is a statement label, then 

DBNE .D@ ,LOOP 
transfers control to the next sequential instruction (Dg is 
not decremented). 
If D@ contains H'@M, the zero bit in the status register is 
set, and LOOP is a statement label, then 

DBNE - DS , LOOP 
transfers control to the next sequential instruction (Df is 


decremented to -l). 


Condition Codes: 
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None of the flags are affected. 


Instruction Fields: 


This instruction requires one word of extension for 
displacement [exp]. 


io Jae hoe oe ae Oe a ee ee 
| ET RS RE ee ae ae ee reg. 
displacement 


The condition field contains one of 16 conditions. 


The cc mnemonic can be one of the following: 


Op Code - Mnemonic - Description 


OOOO DBR ~ always 

Olt} DBE ~ equal 

911@ DBNE ~ not equal 

191 DBC - carry 

9199 DBNC _ no carry 

19129 DBP ~~ positive 

1911 DBN - negative 

1081 DBV ~ overflow 

129 DBNV ~ no overflow 

1119 DBGT = greater than 

1199 DBGE - greater than or equal 
11901 DBLT - less than 

pa a 8 DBLE = less than or equal 
£010 DBH ~ higher than 

9011 DBNH _ not higher than 
GOO1 DEC - never 

G101 DBLO _ low 

G19¢ DBHS - high, or same 


The register field contains the data register which is 
used aS a counter. 


The displacement field contains the 16 bit displacement 
(exp) and specifies the distance of the branch. 
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DIV 
DIVide signed 


DIV .Dd, -@As Operand length(l): W 
-Dd, @Ast 
sDd, /exp {.W or .L)! 
-Dd, [exp]@Ay[(Ri)] 
.Dd, exp[@PC[(Ri)]] 
-Dd, #exp[.W or .L] 
-Dd, .Ds 


Divides the destination (always a data register) by the 
Source and the result is stored in the destination. The 
destination is a long word (32 bits) and the source is a 
word (16 bits). The division is performed using signed 
arithmetic. The result is a long word (32 bits) where: 


ie The quotient is in the lower word. 
2. The remainder is in the upper word. 
3% The sign of the remainder is the same as the 


dividend unless the remainder is zero. 


Special Conditions: 
Division by zero causes a trap. 


Overflow may be detected and set before completion of the 
operation. 


If overflow occurs, the flag is set but the operands are 

unaffected. 

Example: 

If D@ contains H'@M14 and Dl contains -6 (H'FFFA), then 
DIV DD, <DL 


changes the contents of D@ to H'#~P2 FFFD (-3 with a 
remainder of 2). 
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Condition Codes: 


I i I 
a ee oe 


X - Not affected. 

N - Set if the quotient is negative, cleared otherwise, 
undefined if an overflow. 

Z- Set if the quotient is zero, cleared otherwise, 
undefined if overflow. 

V - Set if overflow detected, cleared otherwise. 

C - Always cleared. 


Instruction Fields: 
Ws 2 Re Ee SO a ee Ae ee oe, g 
i ree ee © reg... |)- 1) "ds 1 mode. fren. | 
The register field contains the data (destination) 
register. 


The register and mode fields contain the source 
address mode. 


Radie Shaek 


168 


ASSEMBLER-16 . INSTRUCTIONS 
TRS-8O 


DIVU 
DIVide Unsigned 


DIVU .Dd, -@As Operand length(l): W 

-Dd, @Ast+ 

-Dd, /exp [.W or .L] 

.Dd, [exp]@Ay[ (Ri) ] 

.Dd, exp[@PC[(Ri)]] 

-Dd, #exp[.W or .L] 

-Dd, .DS 
Divides the destination (always a data register) by the 
source and stores the result in the destination. The 
destination is a long word (32 bits) and the source is a 
word (16 bits). The division is performed using unsigned 
arithmetic. The result is a long word (32 bits) where: 

As The quotient is in the lower word. 


a The remainder is in the upper word. 


Special Conditions: 
Division by zero causes a trap. 


Overflow may be detected and set before completion of the 
operation. 


If overflow occurs, the flag is set, but the operands are 
unaffected. 
Example: 
If D@ contains H'#P14 and Dl contains H'@PP4, then 
DIVU PHB) ree a 


changes the content of D@ to H'PPPH BPM5. 


Condition Codes: 


BONO OV oS 
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X - Not affected. 

N > Set 2f the most. signifieant bit of the quotient is set. 
cleared otherwise, undefined if an overflow. 

Z - Set if the quotient is zero, cleared otherwise, 
undefined if an overflow. 

V - Set if an overflow is detected, cleared otherwise. 

C - Always cleared. 


Instruction Fields: 
Us Se eS ek 2 a Bes, ES SD awk. 2 
ae: cae Sey: req. | #2. i | mede- |" red... | 
The register fields contain the data (destination) 
register. 


The register and mode fields contain the source 
address mode. 
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EXT 
sign EXTended 
EXT[1] .Dn Operand length(l1): W, L 


Sign-extends a byte to a word (bit 7 copied in bits 15-8), 
or a word to long word (bit. 15 copied in bits 31-16). 


The operand is always a data register. 


Example: 
Tf D@ contains H'OPOO FPOF, then 
EXTL . DP 


changes the contents of D@ to H'FFFF FQQF. 


Condition Code: 


X Z Z Vow ke 


- Not affected. 

- Set if the result is negative, cleared otherwise. 
Set if the result is zero, cleared otherwise. 

- Always cleared. 

- Always cleared. 


ASNS SK 
i 


Instruction Fields: 


i be ee Ee “f 6 Z 


ae aaa ek a 


The size field contains the size of the sign-extension. 
If the size field is #1@, the sign extension is low 
order byte to word. 

If the size field is Y1ll, the sign extension is low 
order word to long word. 


The register field contains the data register number 
(8-7) to be sign-extended. 
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LD 
LoaD data 


Can be interpretted by the Assembler-16 as four different 
instructions. By the operands used, the Assembler-16 
chooses which instruction to initiate. 

LD ‘bia destination, source 


where the destination is a register and the second operand 
is the data located at source. 
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LD 
LoaD condition codes 


LD[1] -CCR, #exp[.W] Operand length(l): W 
-CCR, -—-@As 
-CCR, @As+ 
-CCR, /exp[.W] 
-CCR, [exp]@As[(R1i) ] 
-CCR, exp[@PC[(Ri)]] 
~CCR;, «Ds 


Loads the content of the source in the condition codes. The 
source is a word but only the low order 8 bits are loaded. 
Example: 


If the condition codes of the status register are all set, 
then 


LDW -CCR,#H'Q@E 
changes the codes so that the extend and carry bits are 
clear, and the negative, zero, and overflow bits are set. 
Condition Codes: 


ie Meee “eet, eee © 


Set all flags according to the source operand. 


Instruction Fields: 


BG, a Ie i SN ee 6 Os 
6 Pe Oe ee med es) 5. eg: 


The register and mode fields contain the addressing 
modes of the source. 
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LD 
LoaD data register 


LD[1] -Dd, -@As Operand length(1): B, W, L 
-Dd, @As+ 
-Dd, /exp[.W or .L] 
-Dd, [exp]@As[ (Ri) ] 
~-Dd, exp[@PC[(Ri)]] 
-Dd, #exp[.W or .L] 
7Das- =Ds 
sDa, «AS (l=wW, L only) 


Loads the contents of the source into a destination data 
register. 


Example: 


If A® points to memory address H'5@@@, which contains H'lF, 
and D@ contains H'@GGH PGHIH, then 


LDB -DP, @AG+ 


changes the contents of D@ to H'@G@OH PY1F, and increments AQ 
BY is 


Condition Codes: 


Ao Ne 


Unaffected. 

Set if the result is negative, cleared otherwise. 
Set if the result is zero, cleared otherwise. 
Always cleared. 

Always cleared. 


Q <m 2 
leu ud wo 


Instruction Fields: 


Me. ee ae ees el, a Se A Oe es Sa ee 


destination source 
G @ size req. mode mode reg. 


The size field contains the size loaded. 
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If the size field contains 91 the size loaded is byte. 
If the size field contains 11 the size loaded is word. 
Tf the size field contains 1@ the size loaded is long. 


The destination fields determine the destination data 
register. Note that the register mode is reverse normal 
order. 


The source fields determine the source addressing mode. 
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LD 
LoaD address register 


LD{1] .Ad, #exp[W or .L] Operand length(l): W, L 

Ad, -@As 

-Ad, @As+ 

Ad, /exp[.W or .L] 

-Ad, [exp]@As[ (Ri) ] 

-Ad, exp[@PC[ (Ri) ]] 

-Ad, .AS 

Ad, .Ds 


Loads the contents of the source to an address register. 


Example: 
If A@ contains H'GOPP BPGH, then 
LDW AQ, #H' FFP 
changes the contents of A@ to H'FFFF FF@P (the source is 


Sign extended). 


Condition Codes: 


None of the flags are affected. 


Instruction Fields: 


Da ee ek ee Or ee Oe iG A De 


destination source 
G @ size reg. oO 2 mode reg. 


The size field contains the size of the operand. 
It tne size field contains 11, 1t is a. word operation, 
The source is sign extended to a long operand and all 
32 bits are loaded into the address register. 
Lf the size Lield contains 10, 1¢ 16 a Jong operation. 
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The destination field contains the destination address 
register. 


The source field contains the addressing mode of the 
source. 
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LDA 
LoaD Address 


LDA Ad, /exp[.W or .L] Operand length(l): L 
-Ad, [fexp]@As[(Ri) ] 
-Ad, exp[@PC[(Ri)]] 
Loads the specified address register with the address of the 
source. All 32 bits of the address register are affected. 


Example: 


If AW contains H'OGGO OPOH, Al contains H'60GP and A2 
contains H'@GPP GG25, then 


LDA .AG,H'1LMY@A1(A2) 


Changes the contents of A@ to H'PPPH6WH35. 


Condition Codes: 


None of the flags are affected. 


Instruction Fields: 
i A a SR ec ee GO Se << SY cm, = me: Ss Se SO gee 
a ae a: neg... | mode = Lar regs. 
The register field determine the address register to 
load. 


The register and mode fields contain the address to be 
loaded. 


Radie Shaek 


Lis 


ASSEMBLER-16 ie INSTRUCTIONS 
TRS-80 


LDM 
LoaD Multiple 


LDM[1] Rlist, @As+ Operand length(1): W, L 
Rlist, /exp 
Rlist, [exp]As([R1i)] 
Rlist, exp[@PC[(R1i)]] 


where R list is a set of registers (destination), separated 
by commas (RX) RY ss 26EC)s 


The registers in Rlist are loaded from consecutive memory 
locations beginning with the location specified by the 
Source operand. The order of loading register is from Dg 
to D7, then from Af to A7. Note that this order is 
independent of the order given in Rlist ( Ale. DS,. D2 woulda 
give the same result as .D2, .D3, A eer. Ge A eed “aS 
stipulated in operand length (1), then the low order word of 
each register is loaded, and the word is sign extended LAEO 
the upper word. 


If the source is the postincrement mode, the incremented 
address register is updated to contain the address of the 
last word loaded plus two. 


Example: 


If the memory addresses H'69PP-69873 contain H'AA AA BB BB, 
and D@ and Dl both contain H'GPPP PGPPH, then 


LDMW .DG,.D1,/H' 6998 


changes the contents of D@ to H'@PPP AAAA, and D1 to H' PPPS 
BBBB. 


Condition Codes: 


None of the flags are affected. 


Instruction Fields: 
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A word extension is added to the operation word for this 
LUSETUCTI ON -CRITsSE). 


PS 1A od! ed 8 es a BS a 
po Mf ed ee P86 sz |- mode i. reg. 7 


The size field contains the size of the operation. 
If the size field contains @, it is word. 
If the size field contains 1, it is: long, 


The register and mode fields contain the source 
addressing mode.9@ 


The Rlist field contains the registers in the Rlist as 
follows: 


od a ee 8s be a BR er a 
A7  A6 _ A5 A4 A3 A2 Al AGS D7 D6 D5 D4 D3 D2 D1 DG 


This is where the bits corresponding to the registers 
included in the Rlist are set. 
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LDP 
LoaD Peripheral data 
LDP[{1] .Dd, [exp]@As Operand length(l): W, L 
Loads the data into the data register (destination) from 
memory (source). The data in memory is formatted as one 
byte per word (the high order byte for even addresses and 
the low order byte for odd addresses). 


Example: 


If A@ contains H'6@9M, addresses H'699H-6993 contain H'FA 23 
1B 3@, and D@ contains H'GOPH OHWPH, then 


LDPW -D#,@AP 


changes the contents of D@ to H'PPPM FAB. 
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OPERAND LENGTH: W 


SOURCE ADDRESS TO DATA REGISTER 


A ag cee nee Cee) a. Oe ees CPO 


ODDS trees eae We eee tee Ded 


Example: 


If A@ contains H'6@9M, addresses H'690H - 6907 contain H'FA 
23 1B 38 25 26 27 28, and D@ contains H'PGOOS OPGH, then 


LDPL -Dg,@a¥g 


changes D@ to H'FAI1B 25 27 


OPERAND LENGTH: L 


MEMORY SOURCE ADDRESS TO DATA REGISTER 


EVEN --> 


ODE ae Apa ees eae 


None of the flags are affected. 


Instruction Fields: 


ey ee ee ee i A, 
gp 8 8 6 | data reg.{1 [9 [sz/M BP Iladd reg. | 


[exp] 


The data register field contains the destination of 
the data register. 
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The size field contains the size of the operation. 
If the size field contains @, the operation is word. 
If the size field contains 1, the operation is long. 


The address register field contains the source address 
register used in indirect mode (plus optional displacement). 


The [exp] field contains the placement used in 
calculating the operand address. 
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ASSEMBLER-16 F INSTRUCTIONS 
TRS-80 


LINK 
LINK and allocate 


LINK .An, #exp Operand length(l): Unsized 


This is a three-step instruction: 


lig The address register specified (.An) is pushed 
onto the stack (.An occupied two words -- 32 
Dats. . 

ZS Then, the address register (.An) is loaded with 


the updated stack pointer. 

Da The sign-extended displacement (two's complement 
integer) is added to the stack pointer (#exp, 
occupies a 16-bit extension of the operation 
word). 


Example: 


If A@ contains H'@M1l 400%, and the SP contains H'PPGG 3096, 
then 


LINK AS, #H'109 
changes the contents of AM to H'#PGH 3002, the SP to H'PGGG 
3002, and memory addresses H'3@%2-3095 to H'OM 11 46 OQ. 
Condition Codes: 


> eS ee ames ila, & 


None of the flags are affected. 


Instruction Fields: 


LS: 14 AS Ooi Ee 39 
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TRS-8O 


The register field contains the address register 
specified in the operand. 


The #exp field determines the two's complement integer 
which is to be added to the stack pointer. 
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MOV 
MOVe 


This instruction can be interpreted by the instruction four 
different ways. The operands used determine which 
instruction the Assembler-16 chooses. 

General Operation: 


MOV[ 1] destination, source 


where the operands are either both memory or both registers. 
The contents of the source is moved to the destination. 
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MOV 
MOVe address register 


MOV[1] .Ad, .AsS Operand length(1l): W, L 
Ad, .DSs 


The destination is an address register. 


Example: 
If Al contains H'FF@@, and AM contains H'PPGG PPG, then 
MOVW.AQ, .Al 


changes the contents of A@ to H'FFFF FF@P% (the source is 
sign extended). 


Condition Codes: 


2 ON Ve i 


None of the flags are affected. 


Instruction Fields: 


Po We oR a a ee Bo Ae a A ae 
4) g size register Oo ¢ J mode reg. 
The size field contains the size of the operand. 
If the size field contains 11, it is a word operation. 
The source is sign extended to a long operand and all 


32 bits are loaded into the address register. 
If the size field contains 18, it is a long operation. 


The destination field determines the destination address 
register. 


The source field determines the addressing mode of the 
source operand. 
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MOV 
MOVe to condition codes 
MOV[1] CCR, Ds Operand length(l): W 
Loads the content of the source into the condition codes. 


Only the low order 8 bits of the source are loaded. The 
source is a word. 


Example: 


If D@ contains H'@M1l, and the condition codes are all 
clear, then 


MOV sCCR, YD 
sets the extend and carry bits of the status register, and 
clears the negative, overflow, and zero bits. 
Condition Codes: 


? Sa ee Soe ee 


All condition codes are set according to the source operand. 


Instruction Fields: 


scale oo es ES ee i ae a eg 


Pete 8 ON ee et I, ode. lu wean. 


The register and mode fields contain the addressing 
mode of the source. 
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MOV 
MOVe general 


MOV[ 1] -Dbd, «Ds Operand length(l): B, W, L 
.Dd, .As (1 = W or L only) 
-@Ax ’ -@Ay 
@Ax+, @Ayt 
-@Ax v @Ay+ 
-@Ax i] /exp 
-@Ax, [exp]@Ay[ (Ri) ] 
-@Ax, exp[@PC[(Ri)]] 
@Axt+ ’ -@Ay 
@Ax+, /exp 
@Ax+, [exp]@Ay[ (Ri) ] 
@Ax+, exp[@PC[(Ri)]] 
/exp ’ @Ax+ 
/expl, /exp2 
/expl, [exp2]@Ax[ (Ri) ] 
/expl, exp2[@PC[(Ri)]] 
[exp]@Ax[(Ri)], -@Ay 
[exp]@Ax[(Ri)], @Ay+ 
[expl1]@Ax[(Ri)], /exp2 
[expl]@Ax[(Ri)], [exp2]@Ay[(Ri)] 
[expl]@Ax[(Ri)], exp2[@PC[(R1)]] 
-@Ax, #eXp 
@Ax+, #exp 
/expl, #exp2 
[expl]@Ax[(Ri)], #exp2 


Moves the contents of the source to the destination (memory 
to memory, or register to data register. 
Example 
Tf D@ contains H'1@~PPM and Dl contains H'FF, then 
MOVB 2DOy.DL 


changes the contents of Df to H'1§@FF 


Condition Codes: 
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TRS-8SO “° 
+ me. eee ae ee, & 
Unaffected. 


Set if result is negative, cleared otherwise. 
Set if result is zero, cleared otherwise. 
Always cleared. 

Always cleared. 


0 <"N oa M& 
tou uw wu 


Instruction Fields: 


Radie Shaek 


199 


ASSEMBLER-16 ‘ INSTRUCTIONS 
TRS-8O 


$50 Sie ha oP a, A Oh oie Ce ce ee 


destination source 
g g size register mode mode req. 


The size field determines what size is moved. 
Tf the size field is @1, it is byte. 
TE: the size ficia 1s 115 120 2s" word. 
Tt the Size ftelda is 179, 26 1s Long. 


The destination fields contain the destination 
addressing mode (note reg./mode is reverse normal order). 


The source fields contain the source addressing mode. 


Radie Shaek 


Loe 


ASSEMBLER-16 r INSTRUCTIONS 
TRS-8O0 


MOV 
MOV from SR 

MOV[1] .Dd, .SR Operand length(l): W 
Moves the contents of the status register to the data 
register. 

Example: 

If the SR contains H'8715 and D@ contains H'@PGsG, then 

MOV -D@,.SR 


changes the contents of D@ to H'8715. 


Condition Codes: 


Ae IN De Ve 


None of the flags are affected. 


Instruction Fields: 


bn La ES = A ae Re OG a ae ee 


PE ete 1, ee ed |e modes to rege.) 


The register and mode fields contain the destination 
data register. 
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ASSEMBLER-16 INSTRUCTIONS 


TRS-8SO ° 
| i 
MUL 
MULtiply signed 
MUL .Dd, -@As Operand length(l): W 
-Dd, @Ast 
-Dd, /exp [.W or .L] 
-Dd, exp]@Ay[(Ri)] 
~-Dd, exp[@PC[ (Ri) ]] 
-Dd, #exp[.W or .L] 
Dd; «Ds 
Multiplies the two signed word (16 bits) operands, producing 
a 32-bit signed result in the destination (data register). 
The register operands are taken from the low order word, 
leaving the high order word unused. All 32 bits of the 
product are saved in the destination. 
Example: 
Tf DG contains H'@P1MH and Dl contains H'FFF5, then 
changes the contents of D@ to H'FFFF FF5Q@. 
) Condition Codes: 
) 
c3 A 
X - Not affected. 
N - Set if the result is negative, cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 
Instruction Fields: 
35 eee eee So ee 1g 
a ae ae: eta Cl eer ee 
The register field contains the data register 
(destination). 
c™ 
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The register and mode fields contain the source 
address mode. 
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TRS-8SO 


MULU 
MULtiply Unsigned 


MULU .Dd, -@As Operand length(l): W 
-Dd, @As+ 
.Dd, /exp [.W or .L] 
.Dd, [exp]@Ay[ (Ri) ] 
.Dd, exp[@PC[ (Ri) ]] 
.Dd, #exp[.W or .L] 
ba; «Ds 


Multiplies two unsigned word (16 bits) operands, producing a 
32-bit unsigned result in the destination (data register). 
The register operands are taken from the low order word; the 
high order word is unused. All 32 bits of the product are 
saved in the destination. 


Example: 
If D@ contains H'@G1G and Dl contains H'PPP5, then 
MULU sD «DL 


changes the contents of D@ to H'PPPH OP5H. 


Condition Codes: 


x NN. 4% V 


Cc 


- Not affected. 

Set if the most significant bit of the result is set, 
cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 


Zw 
I 


Instruction Fields: 


bo eee * “5 19 A 3 ae NG 
331 Ag egister| 11 | mode] reg. 
® 
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The register field contains the data register 
(destination). | 


The register and mode fields contain the source 
address mode. 


® 


Radie Shaek 


196 


ASSEMBLER-16 INSTRUCTIONS 


TRS-8O0 ° 
NEG 
NEGate 
NEG[1] .Dd Operand length(1): B, W, L 
-@Ad 
@Ad+ 


/exp[.W or .L] 
[exp] @Ax[ (Ri) ] 


Subtracts the operand addressed as the destination from 
zero. The result is stored in the destination. 
Example: 
Tf DM contains H'3A, then 

NEGB Dg 


changes the contents of D@ to H'C6. 


Condition Codes: 


> ae Cee eee ae © 


X - Set the same as carry ((c) - if borrow generated), 
cleared otherwise. 

N - Set if the result is negative, cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Set if an overflow is generated, cleared otherwise. 

C - Set if a borrow is generated, cleared otherwise. 


Instruction Fields: 


LS te LS 19 
g a ae oe iia ee 


The size field contains the size of the operation. 
Tf the size field is @l, it is byte. 
Tt the size f1i6éld is gl, it 1s word. 
Tf the Size field is 19, te 1s Long: 
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The register and mode fields contain the destination 
address mode. . 
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TRS-8O 


NEGC 
NEGate with carry 


NEGC[1] .Dd Operand length(l1): B, W, L 
—-@Ad 
@Ad+ 
/exp[.W or .L] 
[exp] @Ax[ (Ri) ] 


Subtracts the operand addressed as the destination and the 
carry bit from zero. The result is stored in the 
destination. 


Example: 


If D@ contains H'34 and the extend bit of the status 
register is set, then 


NEGCB . DP 


changes the contents of D@ to H'CB. 


Condition Codes: 


>, ae ee ee 


X - Set the same as carry ((c) - if borrow generated), 
cleared otherwise. 

N - Set if the result is negative, cleared otherwise. 

Z - Cleared if the result is nonzero, unchanged otherwise. 

V - Set if an overflow is generated, cleared otherwise. 

C - Set if a borrow is generated, cleared otherwise. 


Instruction Fields: 


WS) te ES ee ee eS 8 8 ey 8 


ee oe ee 
6 1 6 6 6 6 @ Bf size] mode | reg. | 


The size field contains the size of the operation. 
If the size field is 92, it is byte. 
if the size field is 91, TE 1S word. 
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If the size tield ie 10 it is long, 


The register and mode fields contain the destination address 
mode. 


Radie Shaek 


299 


ASSEMBLER-16 Re INSTRUCTIONS 
TRS-80 


NEGD 
NEGate Decimal (BCD) with extend 


NEGD -@Ad Operand sizes: B 

@Ad+ 

/exp 

[exp] @Ax[ (Ri) ] 

. Dd 
Subtracts the operand and the extend bit from zero. Binary 
coded decimal arithmetic is used, storing the result in the 
operand address. The ten's complement of the destination 
is produced if the extend bit is clear, if the extend Bit 


is set the nine's complement of the destination is produced. 
This is a byte only operation. 


Example: 


If D@ contains 51 and the extend bit of the status register 
is clear, then 


NEGD Dg 


changes the contents of Df to 49. 


Condition Codes: 


ae ee a ee © 
UC 


X - Set if borrow (BCD) occurred, cleared otherwise (same as 
Sarry tc) 2 

N - Undefined. 

Z - Cleared if the result is nonzero, unchanged otherwise. 

V - Undefined 

C - Set if borrow (BCD) occurred, cleared otherwise. (Same 


as extend (X)). 


Instruction Fields: 


5 2&3 2 3 


® 
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The register and mode fields contain the operand 
destination (the address of the operand.) 
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NOP 
No OPeration 

NOP Operand length(1): Unsized 
No operation occurs. The program counter is incremented by 
two. Otherwise, the processor state is unaffected. 
Example: 
Tf the PC contains H'6999, then 

NOP 


changes the PC to H/6#@2. 


Condition Codes: 


Be NM oe 


None of the flags are affected. 


Instruction Fields: 
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NOT 
logical NOT 


NOT(1L) «Dd Operand length(l): B, W, L 
-@Ax 
@Ax+ 
/exp[.W or .L] 
[exp] @Ax[ (Ri) ] 


The one's complement of the operand is taken and is stored 
in the destination. 


Example 
Lf DO. contains H*3c,. then 
NOTB .DPg 


changes the contents of D@ to H'C3. 


Condition Codes: 


BN a Ve 


- Not affected. 

- Set if the result is negative, cleared otherwise. 
Set if the result is zero, cleared otherwise. 

- Always cleared. 

- Always cleared. 


Cyt bo os 
i 


Instruction Fields: 


VRS met OR a Us I > SR a Ae A a: Oe 
gp ii 68 9 Bf ii 1 § |size| mode | reg. | 


The size field contains the size of the oeration. 
If the size field is 9M, it is byte. 
LE the size field is #1, it: is word. 
TF the size field is 1%, it. is: Long. 


The register and mode fields contain the destination 
address mode. 
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OR 
logical OR 


This instruction can be interpreted by the Assembler-16 two 
differnt ways. By the operands used, the Assembler-16 
chooses which instruction to execute. 

General Operation: 


OR[1] destination, source 


where the source is ORed to the destination and the result 
is stored in the destination. 


The Assembler-16 chooses which instruction to initiate by 
the following guidelines. 


OR immediate used if the source is 
immediate (indicated by a # 
Sign). 

OR data used for all other OR 


operations, one of the 
operands is always a data 
register. 


Condition Codes: (Identical for both operations) 


> ae Se ee 


2 


X - Not affected. 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 
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OR 
logical OR immediate 


OR[1] ~-Dd, #exp[.W or .L] Operand length(l1): B, W, L 
-@Ax, #exp[.W or .L] 
@Ax+, #exp[.W or .L] 

/exp1[.W or .L], #exp2[.W or .L] 

[expl]@Ax[(Ri)], #exp2[.W or .L] 
-CCR, #exp[.W or .L] (1=W only) 


Example: 
If D@ contains H'C6, then 
ORB ~D@, #H'2A 


Changes the contents of D@ to H'ER. 


Instruction Fields: 


ee pee oe ee ee ee Ue, Brees 
word data (16 bits) 


or 


long word data (32 bits including previous word) 


The size field contains the size of the operation. 
If the size field is 9M, it is byte. 
If the size field is @1, it is word. 
If the size field is 10, it is long word. 


The register and mode fields contain the address mode 
of the destination operand. 


The data field contains the data immediately following 

the instruction: 
If the size field is @@, then the data is the low order 
byte of the immediate word (8 bits). 
If the size field is @1l, then the data is the entire 
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immediate word (16 bits). 
If the size field is 1%, then data is the next two 
immediate words (32 bits). 
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OR 
Logical OR data 


Operand length(1):B, W, L 


OR[1] DG, <DS 

-Dd, -@Ay 

-@Ax , .Ds 

~-Dd, @Ay+ 

@Ax+, .DS 

-Dd, /exp[.W or .L] 
/exp[.W or .L], .Ds 
-Dd, [exp]@Ay[ (Ri) 
[exp]@Ax[(Ri)], .Ds 
-Dd, exp[@PC[(Ri)]] 


Example: 
If D@ contains H'C6 and Dl contains H'2A, then 


ORB pO cat 


changes the contents of D@ to H'EE. 


Instruction Fields: 


Se gee ee Rs A a: Sg a eS ee ae a 
1 8 6 $B reg. | size/op|_ mode | reg. | 


The register field contains the data register. 


The size/op field contains the size of the operation and 
the destination of the result: 


Byte Word Long Word Destination 
BOP GO1 G18 data register 
199 191 119 second operand 


The mode and register fields contain the location of 
the second operand. 
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TRS-8SO * 
PUSHA 
PUSH Address 
PUSHA /exp Operand length(l): L 
[exp] @Ax [(Ri)] 
exp [@PC [(Ri)]] 
Computes the address and pushes it into the stack. 
Example: 
If the SP contains H'@GOO 6094, then 
PUSHA H'SPFFOALL 
changes the contents of memory locations H'699P-6993 to H'PP 
FF OA 0M, and the SP to H'GGGH 6HPO. 
Condition Codes: 
> Oe. Gee hae See © 
None of the flags are affected. 
Instruction Fields: 
ES: 34 Le a a oe Bd 
GO te el oe oe mode: . a peg. | 
The register and mode fields contain the address to be 
| pushed onto the stack. 
| 
c~ 
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RET 
RETurn from subroutine 


RET Operand length(l1): Unsized 
Pops a long word from the stack and stores it in the program 
counter (PC). The previous program counter is lost. 
Example: 


If the top of the stack contains H'@M OM 68 OM, then 
RET 


changes the contents of the PC to H'69@M and resumes 
execution from that address. 


Condition Codes: 


me Bo We 


None of the flags are affected. 


Instruction Fields: 
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RTR 
ReTurn with Restore 

RTR Operand length(1): Unsized 
Pops a long word and word off the stack and then stores them 
in the program counter(PC) and condition code register 
(CCR), respectively. The previous values of the PC and CCR 
are lost. The Supervisor portion of the SR is unaffected. 
Example: 
If the top of the stack contains H'# BH 6G BH PP G5, then 

RTR 
sets all of the condition codes of the status register and 
changes the contents of the PC to H'69@M where program 
execution resumes. 


Condition Codes: 


RN ee oN oi 


All flags are set according to the word on the stack. 


Instruction Fields: 
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ROdc 
ROtate 


General Operation: 


Rotates the bits of a specified data register by a count 
contained in either a second data register or an immediate 
expression whose value is in the range 1-8. Memory 
addresses of word length can also be rotated, but only by 
one bit. The direction and category are specified in the 
mnemonics: 


ROL -“ Lett Logical 
ROR ~ Pignuk. Logical 
ROLC - left with carry(extend) 


RORC - right with carry(extend) 
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ROL 


ROtate Left logical 


Bits rotated out of the high order bit go to the carry and 
low order bits. The extend bit is not modified. 
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ROR 
ROtate Right logical 


oe opeRAND [one |e | 


Bits rotated out of the low order bit go to the carry and 
high order bits. The extend bit is not modified. 
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ROLC 


Rotate Left with Carry (extend) 


Bits rotated out of the high order bit go to the carry and 
extend bits. The previous value of extend bit is rotated low 
order bit. 
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RORC 
Rotate Right with Carry (extend) 


> OPERAND ------ . e 


Bits rotated out of the low order bit go to the carry and 


extend bits. The previous extend bit is rotated to low order 
Bit. 
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ROL or ROR 
ROtate logical 


Condition Codes: 


a a ae ae 
ee ee ee 


X - Not affected. 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Set according to the last bit rotated out of the 
operand, cleared for a shift count of @. 
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ROL or ROR 
ROtate logical data 


ROL[1] or Operand length(1):B, W, L 
ROR[1] .Dx, .Dy 
-Dx, #exp[.W or .L] 


Example: 
If D@ contains H'8IPH PHWD, then 
ROLL -DJ, #1 


Changes the contents of D#@ to H'DIGD WIO1. 


Instruction Fields 


U5 4: Se PE oo 8 6 Bs A Be 
ae ee eae 


The count field contains the expression specifying the 
Count. 
If the immediate/register field contains @, the rotate 
count is specified in this field. 
Values are 1-8 where 8 is indicated by @@M; values 1-7 
Sre standard binary, where 991 = 1, 919 = 2 etc. 


The direction field contains the direction of the 
rotation, 
If the direction field contains @, the rotation is to 
the right. 
If the direction field contains 1, the rotation is to 
the left. 


The size field contains the size of the operation. 
If the size field is 9M, it is byte. 
If the size field is @1,. it is word, 
[i-the size field is 17, at 2s long word, 


The immediate/register field contains the 


immediate/register. 
If the immediate register field contains 9, the count 
field contains an expression. 
If the immediate register field contains 1, the count 
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field contains a register. 


The register field contains the specifying register to 
be rotated. 
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ROL or ROR 
ROtate logical memory 


ROL[1] Operand length(l): W 
or 
ROR[1] -@An 
@An+ 
/exp 
[exp]@An[Ri] 


NOTE: rotate of one bit only 


Example: 

If memory address H'59@P contains H'#P42, then 
ROR /H'59PG 

changes the contents of H'59@M to H'MP21. 

Instruction Fields: 


oe be ee ee i a 8 


eS Geka: a AO 
pe ai dr | Ey mede > rege) 


The direction field contains the direction of rotation. 


If the direction field contains Q, the rotation is to 


the right. 


If the direction field contains 1, the rotation is to 


the left. 


The register and mode fields contain the operand to be 
rotated. 
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ROLC or RORC 
ROtate with Carry 


Condition Codes: 


ae: ee aoe aoe 


X - Set according to the bit last rotated out of the 
operand, cleared otherwise. 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

~ Set if the result is zero, cleared otherwise. 

Always cleared. 

-~ Set according to the last bit rotated out of the 
operand, unaffected for a shift count of g. 


QAQGn 
i 
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ROLC{1] or RORC[1] 
ROtate with Carry data 


ROLC[{1] or Operand length(1):B,W,L 
RORC({1] .Dx, .Dy 
-Dx, #exp[.W or .L] 


Example: 


If D@ contains H'#8 and the carry bit of the status register 
is set, then 


RORCB «DO, €2 


changes the contents of D@ to H'42. 


Instruction Fields: 


BO NB ee ie WO Oey 26 ag 
tui i | count [dr[sizeli/r[/T @7 reg. | 


The count field contains the expression Signifying 
register. 
If the immediate/register field contains @%, the rotate 
count is specified in this field, 
Values are 1-8 where 8 is indicated by @@%: values 1-7 
are standard binary where 991 = 1, 910 = 2 etc. 


The direction field contains the direction of the 
rotation. 
If the direction field contains 9, the rotation is to 
the right. 
If the direction field contains 1, the rotation is to 
the left. 


The size field contains the size of the operation. 
If the size field is 9%, it is byte. 
If the size field is 91, it is word. 
If the size field is 1%, it is long word. 


The immediate/register field contains the 


immediate/register. 
If the immediate register field contains @, the count 
field contains an expression. 
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If the immediate register field contains 1, the count 
field contains a register. 


The register field contains the register to be rotated. 
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ROLC or RORC 
ROtate with Carry memory 


ROLC[ 1] Operand length(l): W 
or 
RORC[1] -@An 
@An+ 
/exp 


[exp]@An[ (Ri) ] 


NOTE: Rotation of one bit only 


Example: 


If the memory address H'69@M contains H'F@GM and the carry 
bit of the status register is set, then 


RORC /H' 6999 


changes the contents of address H'699M to H'FOGD. 


Instruction Fields: 


ee TS 19 


—_ er ae ee 


The direction field contains the direction of the 
rotation. 
If the direction field contains 9, the rotation is to 
tHe rigour. 
If the direction field contains 1, the rotation is to 
the left. 


The register and mode fields contain the operand to be 
rotated. 
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SETcc 
SET on condition 


SETcc .Dd Operand Length(1l): Byte 
-@Ad 
@Ad+ 
/exp 
[exp] @Ad[ (Ri) ] 


Tests a condition and sets the destination (byte only) to 
All ones (H'PE) if the condition is true, of to zero 1f£ the 
condition is false. 


Example: 


If DM contains H'@F and the zero bit of the status register 
is set, then 


SETE Dg 


changes the contents of D@ to H'FF. 


Condition Codes: 


= NA Ov 


None of the flags are affected. 


Instruction Fields: 


Se a es ee 


6 5-4 oe SD 

Gg oi Gf 1 [condition [| 1 1 | mode | reg. | 
The condition field is one of 16 conditions. 
The cc mnemonic can be one of the following: 


Op code = Mnemonic - Description 


GOOG - SET - always 
Qlll  - SETE - equal 
911¢ - SETNE - not equal 
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$191 
P19 
1919 
1911 
1991 
1999 
1119 
1199 
1191 
se 
9919 
9911 
P9G1 
J191 
9199 


SETC 
SETNC 
SETP 
SETN 
SETV 
SETNV 
SETGT 
SETGE 
SETLT 
SETLE 
SETH 
SETNH 
SETF 
SETLO 
SETHS 


ae INSTRUCTIONS 
TRS- 


= Carry 
= HO Carry 

- positive 

- negative 

- overflow 

- no overflow 

- greater than 

- greater than or equal 
- less than 

- less than or equal 

- higher than 

- not higher than 

- never 

- low 

- high or same 


The register and mode fields contain the destination 
byte where @ or 255 is stored. 
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SHdc 
SHift 


General Operation: 


Shifts the bits of a specified data register by an amount 
contained either in a second data register or an immediate 
expression whose value is in the range of 1-8. A memory 
address of word length can also be shifted, but only by one 
bit. In all cases the carry bit (C) as well as the extend 
bit (X) receive the bit shifted out of the operand. The 
direction and category are specified in the mnemonic as 
follows: 


SHL left logical 

SHR - right logical 
SHLA - left arithmetic 
SHRA - right arithmetic 
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SHL and SHLA 
SHift Left Logical/Arithmetic 


| C ee OPERAND ae g | 


Shifts the zeroes into the low order bit, and the high order 
bit into the carry and extend bit. 


Note: The only difference in SHL and SHLA is in the 
overflow bit after the operation (See condition codes). 
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SHR 
SHift Right Logical 


| x 


Shifts the operand into the carry bit and the extension bit. 
Shifts a zero into the most significant bit. 
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SHRA 
SHift Right Arithmetic 


--> OPERAND ~~ |[------ , C 
>] x | 


Replicates the sign bit and shifts the least significant bit 
into the carry and extend bits. 
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SHL or SHR 
SHift logical 
Condition Codes: 


> ee a ee ae © 
. ke 


X - Set according to the last bit shifted out of the 
operand, unaffected for a shift count of zero. 

N - Set if the result is negative, cleared otherwise. 

7Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Set according to the last bit shifted out of the 


operand, cleared for a shift count of zero. 
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SHL or SHR 
SHift logical data 


SHL[1] Operand length(1):B,W,L 
or 
SHR[1].Dx, .Dy 
~.Dx, #exp[.W or .L] 


Example: 
If D@ contains H'8132, then 
SHLW DP, #1 
changes the contents of D@ to H'G264. 
If D@ contains H'8132, then 
SHRW DG, #1 


changes the contents of D@ to H'4999. 


Instruction Fields: 


cs ae +3 “4 19 


ar sie Ter et cea 


The count field contains the expression signifying the 
count. 
If the immendiate/register field contains @, shift 
count is specified in this field. Values are 1-8 where 
8 is indicated by @@W%; values 1-7 are standard binary, 
where 991 = 1 919 = 2 etc. 


The direction field contains the direction of the shift. 
If the direction field contains 9, the shift is to the 
rig. 
If the direction field contains 1, the shift is to the 
left. 


The size field contains the size of the operation. 
If the size field is 9M, it is byte. 
If the size field is @1l, it is word. 
If the size field is 19, it is long word. 
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The immediate/register field contains the 
immediate/register. 
If the immediate/register field contains @, the count 
field contains an expression. 
If the immediate/register field contains 1, the count 
field contains a register. 


The register field contains the register to be shifted. 
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SHift logical memory 


SHL[1] Operand length(l): W 
or 
SHR[1] 
-@An 
@An+ 
/exp 


[exp] @An[ (Ri) ] 


NOTE: Shift of one bit only 


Example: 

If memory address H'609M contains H'7341, then 
SHLW /H'69DB 

changes the contents of address H'699M to H'E682. 

If memory address H'699@ contains H'7341, then 
SHRW /H'6 999 


changes the contents of address H'609M to H'39AQ. 


Instruction Fields: 


ds oe 2 SE Se ee a Ce: a ee 


See ee Dee ee | 
ee a ae es ee ae fo ee Se ee a ae 


The direction field contains the the direction of the 
shift, 

If the direction field contains 9, the shift is to the 

right. 

If the direction field contains 1, the shift is to the 
left. 


The register and mode fields contain the operand to be 
shifted. 
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SHLA or SHRA 
SHift Arithmetic 


Condition Codes: 


ae: ee ae ae © 


X - Set according to the last bit shifted out of operand, 
unaffected for a shift count of zero. 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Set if the most significant bit is changed at anytime 
during the operation; cleared otherwise. 

C - Set according to the last bit shifted out of the 
operand; cleared for a shift count of zero. 
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SHLA[1] 
SHift Arithmetic data 


SHLAC[1] Operand length(1):B, W, L 


or 

SHRA[1].Dx, .Dy 
-Dx, #exp[{.W or .L] 
Example: 
If DM contains H'8132, then 
SHLAW DP, #1 

changes the contents of D@ to H'G264. 
If D@ contains H'8132, then 
SHRAW DP, #1 


changes the contents of D@ to H'Cg99. 


Instruction Fields: 


ioe. eo ee 


| ie ae ge Se Sec a a | 
tt 8 | count — fart size[ai/r]v lo |. “veg. | 


The count field contains the expression Signifying the 


count. 


If the immediate/register contains @, the shift count 


is specified in this field. 


Values are 1-8 where 8 is indicated by #9; values 1-7 
are standard binary, where 991 = 1, @1% = 2 etc. 


The direction field contains the direction of the 
If the direction field contains @, the shift 
EIGHE. 

If the direction field contains 1, the shift 
left. 


The size field contains the size of the operation. 


If the size field is 9M, it is byte. 
If the size field is 91, it is word. 
If the-size field is 19, it i¢ long word. 
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The immediate/register field contains the 
immediate/register. 
If the immediate/register field contains @, the count 
field contains an expression. 
If the immediate/register field contains 1, the count 
field contains a register. 


The register field contains the register to be shifted. 
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SHLA or SHRA 
SHift Arithmetic memory 


SHLA[1] Operand length(l1): W 
or 
SHRA[1] -@An 
@An+ 
/exp 


[exp] @An[ (Ri) ] 


NOTE? Shitt of one bit only 


Example: 

If memory address H'69@@ contains H'7341, then 
SHLAW /H' 6999 

changes the contents of address H'69@@ to H'E682. 

If memory address H'69M%M contains H'7341, then 
SHRAW /H' 6999 


changes the contents of address H'69@M to H'39AQ. 


Instruction Fields: 


bo. «PA alo 22> i. . Ag 8 8 


(ae ae =e i ey Re a | 
be PP dr th mode. regs 


The direction field contains the direction of the shift. 
If the direction field contains @, the shift is to the 
panied a. ae 
If the direction field contains 1, the shift is to the 
left. 


The register and mode fields contain the operand to be 
shifted. 
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ST 
STore 


This instruction can be interpreted by the Assembler-1l6 as 
two different instructions. By the operands used, the 
Assembler-16 chooses which instuction to initiate. 

General Operation: 


oe ee source, destination 


where the source is the contents of a register and the 
destination is an address in memory or another register. 
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ST 
STore data/address register 


ST[1] -Ds, -@Ad Operand length(1l): B, W, L 
-Ds, @Ad+ 
-Ds, /exp[.W or .L] 
-Ds, [exp]@Ad[ (Ri) ] 
-Ds, .Ad 
-Ds, .Dd 
-AS, -@Ad 
-AS, @Ad+ (Note: all operations using 
-As, /exp[.W or .L] Address Register direct mode 
-As, [exp]@Ad[ (Ri) ] have 1 = W or L only.) 
-As, .Ad 
-AsS, .Dd 


Example: 
If D@ contains H'FOPF and AM contains H'699%, then 


STW .D¢M,@AG+ 


changes the contents of the memory address H'699P@ to H'FOUGF 
and increments A@ by 2. 


Condition Codes: 


A oN ON Oe 


A ee aE a a 


Unaffected. 

Set if the result is negative, cleared otherwise. 
Set if the result is zero, cleared otherwise. 
Always cleared. 

Always cleared. 


AMCnNaZéx 
tou wou dl 


Instruction Fields: 


LO. Ae Se ed a 28 Ge. a ee g 
destination source 
g g size reg. mode mode reg. 


The size field contains the size loaded. 
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If the size field is 91, it is byte. 
If the size field is 11, it is word. 
Tf the size field is 19, it is long. 


The destination fields contain the destination 
addressing mode. 


The source fields contain the source register. 
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ST 
STore status register 


ST[{1] -SR, Ad Operand length(l): W 
-SR, @Ad+ 
-SR, /exp[.W] 
-SR, [exp]@Ad[(Ri)] 
.oR> .-Dd 
Example 
If the SR contains H'8715, then 
ST .SR,.D@ 


changes the contents of D@ to H'8715. 


Condition Codes: 


eee a ae 


None of the flags are affected. 


Instruction Fields: 


ts ae ee Os Se Oe? oe A? ee; 2 | i) 


The register and mode fields contain the addressing 
mode of the destination. 
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STM 
STore Multiple 


STM[1] Rlist, -@Ad Operand length(1): W,L 
Rlist, /exp 
Rlist, [exp]@Ad[(Ri)] 


Where Rlist is a set of registers (Source) separated by 
commas (.Rx, .Ry...etc). 


Stores the contents of the registers in Rlist in consecutive 
memory locations beginning with the location specified by 
the destination operand. The order of the register contents 
is D@ to D7 and A® to A7; except in the predecrementing 
mode where the order is A7 to AZ, D7 to DM. Note that this 
order holds independently of the order given in Rlist (.Al, 
.D3, .D2 gives the same results as .D2, .D3, and .Al). If a 
word is stipulated in the operand length(1l), then the low 
order word of the register is stored. 


If the destination operand is addressed in the predecrement 
mode, the registers are stored beginning with the specified 
address, minus two, and continues down through the lower 
addresses. The decremented address register is updated to 
contain the address of the last word stored. 
Example: 
If DM contains H'FFFF and Dl contains H'#PFF, then 

STMW .Df, .D1l, /H'69PG 
changes the contents of memory addresses H'699M-6993 to H'FF 
FF O90 FF. 


Condition Codes: 


5 a 


None of the flags are affected. 


Instruction Fields: 
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de A os en a Sg 7 IG = A Se De 
ih. Oe te os fee) ede th reg 
The size field contains the size of the operation. 


If the size field is 9, it is word. 
Tf the size field is 2) At as Lond. 


The register and mode fields contain the source 
addressing mode. 


The Rlist field contains the registers in Rlist as 
follows: 


Bs a ED ee 9 GB ie de 

Avy AG A5 A4 A3 A2 Al AM D7 D6 D5 D4 D3 D2 Di DF 
or, for the predecrement mode (where bits corresponding to 
the registers included in Rlist are set), the Rlist field 


contains the registers as follows: 


oe Ee a 6 Gd A og 
DY. Dl 02 D3 D4 D5. D6 D7 AU Al AD AS Ad AS AG AT 


A word extension is added to the operation word for this 
instruction (Rlist). 
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STP 
STore Peripheral 

STP[1] .Ds, [exp]@Ad Operand length(1): W, L 
Loads data from the data register (source) to alternate 
bytes of memory. 

Examples: 

If D@® contains H'@1FF 2FF1, and AM contains H'6999, then 

STPL DP, GAP 


changes the contents of memory address H'699M to H'G1, 
H'6992 to H'FF, H'6994 to H'2F, and H'69M6 to H'FI. 


OPERAND LENGTH: L 
DESTINATION ADDRESS 


EVEN 


DATA REGISTER C 


-> [oo —> 
Siri 


---> ODD 


eae ie ak 


If DW contains H'M1FF and AM contains H'699M, then 
STPW DP, @AG 


changes the contents of memory address H'69@M to H'M1 and 
address H'69@2 to H'FF. 
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OPERAND LENGTH: W 
DESTINATION ADDRESS 


EVEN 


DATA REGISTER 


Sey ae LS PEL 
ee Seats ee a ee 


---> ODD 


es es 


Condition Codes: 


2 SN ati ee 
None of the flags are affected. 


Instruction Fields: 


15, 1A 13 eS eS A Sa a. 
pate eae ea 


The size field contains the size of the operation. 
If the size field is 0. Ae Ls: word. 
It the size field 1s 1; if ise long. 


The data register field contains the source of the 
data register. 


The address register field contains the address 
register used in the indirect mode (plus optional 
displacement). 


The [exp] field specifies the displacement used in 
calculating the operand address. 
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SUB 
SUBtract 


This instruction can be interpreted by the Assembler-1l6 four 
different ways. The Assembler-16 specifies which is to be 
executed by the operands used. 


General Operation: 
SUB[1] destination, source 


where the source is subtracted from the destination (d) and 
the result is stored in the destination. The size of the 
operation will vary from one operation to another and is 
optionally stipulated. 


The Assembler-16 chooses which instruction to execute 
according to the following guidelines: 


SUB quick source is immediate (indicated 
by a # sign) and in the value 
range 1-8. 


SUB address destination is an address 
register. 


SUB immediate source is immediate and 
greater than 8 (more than 
3-bit-data). 

SUB data register all remaining subtraction 


operations. A data register is 
always one of the operands. 
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SUB 
SUB quick/ SUB immediate 


SUB[1] -Dd , #exp[.W or .L] Operand length(l): B, W, L 
-@Ad, #exp[.W or .L] 
@Ad+, #exp[.W or .L] 
fexpl(.W or .L], #exp2[.W or .L] 
[expl]@Ax[(Ri)], #exp2[.W or .L] 
-Ad, #exp[.W or .L] (quick only) 


Example: 
If D@ contains H'3F95, then 


SUBB 0)! ee ae 


changes the contents of D@ to H'3FQ@2. 


Condition Codes: 


aN) 3g 


X - Set the same as carry, set if borrow is generated, 
cleared otherwise. 

N - Set if the result is negative, cleared otherwise. 

Z —- Set if the result is zero, cleared otherwise. 

V - Set if the overflow is generated, cleared otherwise. 

C - Set if borrow is generated, cleared otherwise. 


No flags are affected if Subtraction to Address register is 
made. 


Instruction Fields: SUB quick 


£5 12. 13 (12 Mi Te 39 


2 AE Soe Se Se es” Oe aaa | 
g@ ii 8 i. | data 71 [size[ mode T reg. | 


The data field contains 3-bit data, values 1-8, (@M1-111 
= 1-7 decimal: @8W=8 decimal) 


The size field contains the size of the operation. 
If the size field is @M, it is byte. 
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T£ the size field is 91, it is word. 
LE the size field is 10, 1t 1s long word. 


The register and mode fields contain the destination. 
If the size field is byte then the address register 
direct is not allowed. 
Tf the size field is word and the destination is the 
address Register, the source is sign-extended to 
32-bits (see SUB address register). 


Condition Codes: 


SNe VO 


X - Set the same as carry(C), set if borrow is generated, 
cleared otherwise. 


N - Set if the result is negative, cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 

V - Set if overflow is generated, cleared otherwise. 
C - Set if borrow is generated, cleared otherwise. 
Instruction Fields: SUB immediate 


Operand length(1): B,W,L 


The number of extensions for the immediate data vary 
according to the size of the operation (see data fields). 


a aa aaa i ee or ee, 
word data (16 bits) 


or 


long word data (32 bits, including previous word) 


The size field contains the size of the operation. 
TE the: size field is 02, it: is byte. 
If the size field is 91, it is word. 
Tf the size field is 19, it is long word. 
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The register and mode fields contain the address mode 
of the destination operand. 


The data fields contain the data immediately following 

the instruction: 
If the size field is 0%, the data is in the low order 
byte of the immediate word (8 bits). 
If the size field is @1, the data is the entire 
immediate word (16 bits). 
If the size field is 19, the data is the next two 
immediate words (32 bits). 
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SUB 
SUB address register 


SUB[1] .Ad, .As Operand length(1):W,L 
.Ad, .Ds 
Ad, -@As 
-Ad, @As+ 
.Ad, /exp[.W or .L] 
-Ad, [exp]@Ay[(Ri)] 
.Ad, exp[@PC[(R1i)]] 
Ad, #exp[.W or .L](SUB immediate only) 


Note that an address register is always the destination 
operand. 


Example: 


If A@ contains H'@Y3F PG1G and Al contains H'GIWH BHW4, then 


SUBL AM, .Al 


changes the contents of AM to H'DP3F PPAC. 


Condition Codes: 


am NWN. 2 VO 


None of the flags are affected. 


Instruction Fields: 


VHS CeO sc a gm SI OR: ae = a = gO =” eee 
lL 0. gt | reg.) | size | mode reg. | 


The register(d) field contains the destination operand. 
It can be any address register. 


The size field contains the size of the operation. 
Tf the size field is 911, it is word. The source 


operand is sign-extended (see EXT) to fill 32 bits of 


the address register. 
Tf tthe size field 126 i111, 1t as) long word, 
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The register and mode fields contain the address mode 
of the source operand. 
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SUB 
SUB data register 


Operand length(1):B, W, L 


SUB[1] .Dd, .Ds : 
-Dd, -@As : -@Ad ,.Ds 
-Dd, @As+ : @Ad+,.Ds 
.Dd, /exp[.W or .L] : /exp[.W or .L],.Ds 
-Dd, [exp]@Ay[(Ri)] : [exp]@Ax[(Ri)],.Ds 
Dd, exp[@PC[(Ri)]] : 
Dd, .ASs : 

operand list continued in next column 


A data register is always one of the operands. 


Example: 
If DM contains H'3F and Dl contains H'1@; then 
SUBB 2007 at 


changes the contents of D@ to H'2F. 


Condition Codes: 


x ON 2. Vo OG 


X - Set if a borrow occurred, cleared otherwise (same as 
CarrytC) }. 

N - Set if the result is negative, cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Set if an overflow is generated, cleared otherwise. 

Cc - Set if a borrow occurred, cleared otherwise. 


Instruction Fields: 


Es de 0 Sey Seg WS n° RT aa See: a Re” 
ns: ae ae reg. | size/op | mode | reg. | 


The register field contains the data register. 
The size/op field contains the size of the operation and 
specifies the destination of the result: 
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Byte Word Long Word Destination 
rae FP1 an data register 
199 1971 119 second operand 


The mode and register fields contain the location of 
the second operand. 


If the second operand is the source operand and its 
Size is one byte, the address register direct 
addressing mode is not permitted. 
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SUBC 
SUBtract with Carry 


SUBC[1] .Dd, .Ds Operand Sizes: B, W, L 
-@Ad, -@As 


Subtracts the source and the carry bit from the destination. 
The results are stored in the destination location. 


Example: 


If D@ contains H'3F, Dl contains H'1@, and the carry bit of 
the status register is set, then 


SUBCB Dee Dd 


changes the contents of D@ to H'2E. 


Condition Codes: 


& Neve 


- The same as carry; set if carry generated, cleared 
otherwise. 

- Set if the result is negative, cleared otherwise. 
Cleared if the result is nonzero, unchanged otherwise. 
- Set if overflow is generated, cleared otherwise. 

- Set if carry is generated, cleared otherwise. 


AIGN ms 
i 


Instruction Fields: 


Po, ta ee ie 8 6 A ee 
[| reg.(d) [1] size] @ | r/m|reg.(s) | 


The R/M field contains the operand addressing mode. 
If the R/M field is @, the operation is from data 
register to data register. 
Tf the R/M field is 1, the operation is from memory to 
memory. 


The size field contains the size of the operation. 
Tf the saze field 16 47, 10 16. byte. 
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If the size field is @1, it is word. 
If the size field is 19, it is long word. 
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SUBD 
SUBtract Decimal (BCD) with extend 


SUBD .Dd, .Ds Operand sizes: B 

-@Ad, -@As 
Subtracts the source and the extend bit from the 
destination. The result is stored in the destination. 
Binary coded decimal arithmetic is used. The operation 
size is byte only. 


Example: 


Tf D® contains 41, Dl contains 35, and the carry bit is 
clear, then 


SUBD ADO. <Di 


changes the contents of D@ to #6. 


Condition Codes: 


A hi 


X - Same as carry; set if borrow (BCD) occurs, cleared 
otherwise. 

N - Undefined. 

Z - Cleared if the result is nonzero, unchanged otherwise. 

V - Undefined. 

C - Set if borrow (BCD) occurs, cleared otherwise. 


Instruction Fields: 


eS oS Se A. OS OR FB oe a ee 
yo W] reg. (a) [1 0 8 OF D[x/m[reg. (5) 


The register(d) field contains the destination register. 
Tf the R/M field is @, reg(d) is a data register. 
If the R/M is 1, reg(d) is address register in the 
predecrement addressing mode. 


The R/M field contains the operand addressing mode. 
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If the R/M field is @, the operation is from data 
register to data register. 

If the R/M field is 1, the operation is from memory to 
memory. 


The register(s) field contains the source register. 
If the R/M field is @, register(s) is a data register. 
If the R/M field is 1, register(s) is an address 
register in predecrement addressing mode. 
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TEST 
TEST an operand 


TEST(1) .Dn Operand length(1): B, W, L 
-@An 
@An+ 
/exp[.W or .L] 
[exp]@An[ (Ri) ] 


Compares the operand to zero. Sets the condition codes 
according to the results. No results are saved. 


Example: 
If DY contains H'#PM, then 
TESTB .Dg 


sets the zero bit of the status register and clears all 
other status bits. 


Condition Codes: 


x. Wee ee 


Not affected. 

Set if the operand is negative, cleared otherwise. 
Set if the operand is zero, cleared otherwise. 
Always cleared. 

Always cleared. 


AMINA SM 
oui ue il 


Instruction Fields: 


See es Ee Os Lo es 


eee ee eee 
G9 i fg 9 I G@ 1 VB |sizel mode | reg. 


The size field contains the size of the operation. 
Et the size f1seld 1s 90. At 16 “byte. 
tft the Sige field is UL, -1e- 25. word, 
Tt the Sige field te 10, it 156 “long: 
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The register and mode fields contain the addressing 
mode of the operand being tested. 
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TESTSET 
TEST and SET indivisible 


TESTSET .Dn Operand length(1l): B 
-@An 
@An+ 
/exp[.W or .L] 
[exp]@An[ (Ri) ] 


Tests the operand (byte) for negative and zero conditions, 
and then sets the most significant bit of the byte. The 
operation is indivisible (noninterruptable) in a multi-user 
environment. 


Example: 
Tf DM contains H'@P, then 
TES LOE TL . Da 


sets the zero bit of the status register and changes the 
contents of D@ to H' 8%. 


Condition Codes: 


NA 


C 
i cee eae | 


- Not affected. 

Set if the most significant bit of the operand is set, 
cleared otherwise. 

- Set if the operand zero, cleared otherwise. 

Always cleared. 

- Always cleared. 


Zan 
l 


<< 3 
\ 


Instruction Fields: 


NG side Tae 2 ii 0 8 Be ie. Ae 
Ca 0 ee ee | mode: |S reg 


The register and mode fields contain the operand 
addressing mode. 
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TEST1 
TEST bit 


General Operation: 


Tests a bit (Specified by the source) in the destination. 
The state of the tested bit is reflected in the Z condition 
code. If a data register is the destination, then the bit 
numbering is modulo 32(long word). If the destination is in 
memory, the operation is performed using modulo 8 (byte) and 
the contents of the byte are unchanged. 


TESTED I source(s) destination(d) 


Condition Codes: 


Bn De ie 


- Not affected. 
- Not affected. 
if the bit tested is zero, cleared otherwise. 
- Not affected. 
- Not affected. 


AINA N 
i 
op) 
0) 
ct 
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TEST1 data register 


TEST1[1] .Ds, -@Ay Operand length(1l): B for 
-Ds, @Ay+ memory destination 
-Ds, /exp L for data register 
-Ds, [exp]@Ay[ (Ri) ] destination 
-Ds, exp[@PC[(Ri)]] 
.DS,. .Dd 

The source is a data register (specified as the first 

operand). 

Example: 


If D@ contains H'#PIF GPAG5 and Dl contains H'PPPH WHH4, then 
TESTILL ,D0¢ «DL 


sets the zero bit of the status register. 


Instruction Fields: 


SB dA eee) I ae OB eee 6 ab oe ee wD 

G @ OO @ { reg.(s) | 1] BG] GB] mode | reg. | 
The register(s) field contains the data register which 
contains the bit number 


The register and mode fields contain the destination 
operand. 
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TEST1 immediate 


TEST1[1] #exp, Dd Operand length(l1): B for 
#exp, -@Ad memory destination L for 
#exp, @Ad+ Data Register destination. 


#expl, /exp2 
#expl, [exp2]@Ad[ (Ri) ] 
#expl, exp2[@PC[ (Ri) ]] 
Note: source (first operand) is immediate, requires a second 
word of instruction: 
Example: 
If D@ contains H'@5, then 
TES TLL #3, .DP 


sets the zero bit of the status register. 


Instruction Fields: 


By A Se eS Se 8 a Be ee Ee A a e, , g 
fe ioe ts Peet, we amade [sega 


The register and mode fields contain the destination. 


The bit number field specifies the bit number. 


Radie Shaek 


264 


ASSEMBLER-16 INSTRUCTIONS 
TRS-8SO ° 


TESTCLR1 
TEST and CLeaR bit 


General Operation: 


Tests a bit (specified by the source) in the destination. 
The state of the tested bit is reflected in the Z condition 
code. After the test, the bit is cleared. If a data 
register is the destination, then the bit numbering is 
modulo 32 (long word). If the destination is in memory, 
the operation is performed using modulo 8 (byte) and the 
byte is written back to the location. 


TESTCLRI[1] source, destination 


Condition Codes: 


aN. 2 Vo 


- Not affected. 
- Not affected. 
if the bit tested is zero, cleared otherwise. 
- Not affected. 
- Not affected. 


QAIN AZM 
i 
ep) 
4) 
‘KS 
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TESTCLR1 data register 


TESTCLRI[1] .Ds, -@Ay Operand length: B for memory 
-Ds, @Ay+ destination. L for Data 
-Ds, /exp Register destination. 
-Ds, [exp]@Ay[(R1i)] 
«DS, «Dd 


The source is a data register (specified as the first 
operand). 
Example: 
If D@ contians H'@5 and Dl contains H'1F, then 
TES TCLERIG £OY 0 24 
changes the contents of Dl to H'1F and sets the zero bit of 
the status register. 
Instruction Fields: 


is) 14 ee AS ee 9 8 5 1 g 
ait iat ee 


The register(s) field contains the data register which 
contains the bit number. 


The register and mode fields contain the destination 
operand. 
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TESTCLR1 immediate 


TESTCLRI[1] #exp, .Dd Operand length(1): B for memory 
#exp, —@Ad destination. L for data 
#exp, @Ad+ register destination. 


#expl, /exp2 
#expl, [exp2]@Ad[(Ri)] 


The source (first operand) is immediate, and requires a 
second word of instruction: 
Example: 
If DM contains H'FPM, then 
TESTCLRIL #3, .D@ 


sets the zero bit of the status register (DM is unchanged). 


Instruction Fields: 
Ny STs ot Ee i, ee a ae ey ie Sie Sd ea ee 


The register and mode fields contain. the destination. 


The bit number field specifies the bit number. 
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TESTNOTIL1 
TEST and NOT bit 


General Operation: 


Tests a bit (Specified by the source) in the destination. 
The state of the tested bit is reflected in the Z condition 
code. After the test, the bit is changed (NOT). If a data 
register is the destination, then the bit numbering is 
modulo 32 (long word). If the destination is in memory, the 
operation is performed using modulo 8 (byte) and the byte is 
written back to the location. 


TESTNOTL[ 1] source, destination 


Condition Codes: 


fe 


- Not affected. 
- Not affected. 
if the bit tested is zero, cleared otherwise. 
- Not affected. 
- Not affected. 


QAIn a ne 
{ 
~ 
4) 
ct 
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TESTNOT1 data register 


TESTNOT1[1] .Ds, -@Ay Operand length(1l1): B for memory 
-Ds, @Ay+ destination. L for Data 
-Ds, /exp Register destination 
-Ds, [exp]@Ay[ (Ri) ] 
.Ds, .Dd 


The source is a data register (specified as the first 
operand). 
Example: 
If DM contains H'#4 and Dl contains H'@4, then 
TESTNOTLL *De- «DL 
changes the contents of Dl to H'l4 and sets the zero bit in 
the status register. 
Instruction Fields: 


SS tay Fame Ie ee eae De a 2? a? a aT Se «Rees pee Ue Ee cae ee | 
ao @  @ | reg.(s) | 1] @] 1] mode [ reg. | 


The register(s) field contains the data register which 
contains the bit number. 


The register and mode fields contain the destination 
operand. 
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TESTNOT1 immediate 


TESTNOT1[1] #exp, .Dd Operand length(1): B for memory 
#exp, -@Ad destination. L for Data 
#exp, @Ad+ Register destination. 


#expl, /exp2 
#expl, [exp2]@AdI[ (Ri) ] 


The source (first operand) is immediate, and requires a 
second word of instruction: 
Example: 
If D® contains H'FPM, then 
TESTNOTIL #5, .Dg 
changes the contents of D@ to H'DM and sets the zero bit of 
the status register. 
Instruction Fields: 


ig ee ce ei a <a ee ie ee 
0D Nd ode lr rege | 
fe bre number | 


The register and mode fields contain the destination. 


The bit number field contains the bit number. 
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UNLinK 
UNLK .An Operand length(1): Unsized 


Undoes A LINK. Loads the stack pointer from the specified 
address register. The address register is loaded with the 
long word pulled from the top of the stack. 


Example: 


If AW contains H'GOPPFFPP and the memory address H'WIPP FFMGP 
contains H'@@ FA 0M WM, then 


UNLK Ag 
changes the contents of A@ to H'GMFA BIPM and the SP now 
contains H'G9OO FFM4. 
Condition Codes: 


Ne ee Ve 


None of the flags are affected. 


Instruction Fields: 


Vs aa gt it re ae am: ie See a a sea a 
ee Pe ee ee rege 2 


The register field contains the address register through 
which the unlinking is to be done. 
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XCH 
eXCHange 


This instruction can be interpreted by the Assembler-16 as 
two different instructions. The operands used determine 
which instruction is executed. 


XCH[1].Ax, .Ay eXCHange registers Operand length(l): L 
.Ax, .Dy 
-DxX, . Dv 
-DX, .AY 


The contents of two Registers (32 bits) are exchanged. 


Example: 

If D@ contains H'FFGMY FFPM and Dl contains H'12FF PPP, then 
XCH DP, «DL 

changes the contents of D@ to H'12FF 99WH and Dl to H'FFPY 

FFQZ. 

Condition Codes: 


A oD 2 


None of the flags are affected. 


Instruction Fields: 


1S gem ac Se 6 O° = ee CO RY A 
td | reg. x |) op/mode jy, reg. ¥ | 


The register X field contains one of the registers. 
If the exchange is between the data register and address 
register, the data register is specified here. 


The op/mode field specifies the type of exchange. 
If the op/mode field is 9199, it is data registers. 
If the op/mode field is 919@1, it is address registers. 
If the op/mode field is 19@#1, it is both data register 
and address register. 
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The register Y field contains the second register. If 
the exchange is between address and data registers the 
address register is specified here. 
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XCH[1] .Dn 
eXCHange words 
Operand length(l1): W 
Exchanges the high order word (16 bits) and low order words 
(16 bits) in a data register. 
Example: 
If DM@ contains H'FOGF PIV, then 
XCH . DP 


changes the contents of D@ to H'PSWGS FOUOF. 


Condition Codes: 


Be Noe OV Se 


| 


- Not affected. 

Set if the most significant bit of the 32-bit result is 
set, cleared otherwise. 

- Set if the 32-bit result is zero, cleared otherwise. 
Always cleared. 

- Always cleared. 


Zr 
l 


Qaim 
I 


Instruction Fields: 


us came Ses Se Nc We 2 Ga Di <n Sc 
Boe eV ee regia 4 


The register field contains the data register used. 
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XOR 
eXclusive OR logical 


This instruction can be interpreted by the Assembler-16 as 
two different instructions. By the operands used, the 
Assembler-16 determines which instruction to execute. 


General Operation: 
XOR[1] destination(d), source(s) 


where the source is eXclusive ORed to the destination. The 
result is stored in the destination. 


The Assembler-16 chooses which instruction to initiate by 
the Following guidelines: 


XOR immediate if the source is immediate 
(indicated by a # sign). 


XOR data if the source is a data 
register. 


Condition Codes: (Identical for both operations) 


> aes. Rey Cee ae © 


X - Not affected. 

N - Set if the most significant bit of the result is set, 
cleared otherwise. 

- Set if result is zero, cleared otherwise. 

Always cleared. 

- Always cleared. 


Qan 
i 
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XOR 
eXclusive OR data 


XOR[1] -Dd, .Ds Operand length(l): B, W, L 
-@Ax, .DS 
@Ax+, .DS 

[exp]@Ax[(Ri)], .Ds 

/exp[.W or .L], .Ds 

Example: 

If D@ contains H'F5 and Dl contains H'9@7, then 

XORB (O87 .DL 


changes the contents of D®@ to H'F2. 


Instruction Fields: 


LES ge ee ss Sp N°: iy CY NG Sc Sa 
Lf 1d reg.(s) | size/op| mode | reg. | 


The register(s) field contains the data register. 


The size/op field is as below: 


Byte Word Long Word 
19P 191 119 


The register and mode fields contain the destination 
operand. 
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XOR 
eXclusive OR immediate 


XOR[1] -Dd, #exp[.W or .L] Operand length(l): B, W, L 
-@Ax, #exp[.W or .L] 
@Ax+, #exp[.W or .L] 

/expl[.W or .L], #exp2[.W or .L] 

[expl1]@Ax[(Ri)], #texp2[.W or .L] 
-CCR, #exp[.W or .L] (1=B, W only) 


Example: 
If D®@ contains H'1B5A, then 


XORW .DP, #H'FOFD 


changes the contents of D@ to H'EBAA. 


Instruction Fields: 


Le ae 2 Ze ee A 


Ps ee ee ee | DYES Gata 18 brs) 
word data (16 bits) 


or 


long word data (32 bits, including previous word) 


The size field contains the size of the operation. 
If the size field is 9M, it is byte. 
Tf the sive field is 01. if 1s. word. 
If the size field is 1%, it is long word. 


The register and mode fields contain the address mode 
of the destination operand. 


The data fields contain the data immediately following 

the instruction: 
If the size field is @%, the the data is the low order 
byte of the immediate word (8 bits). 
If the size field is #1, the the data is the entire 
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immediate word (16 bits). 
If the size field:is 1%, the the data is the next two 
immediate words (32 bits). 
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CHAPTER 9 


DIRECTIVES 
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CHAPTER 9/ DIRECTIVES 


Assembler directives are commands to the Assembler-l6 (and 
not 68998 machine instructions). A directive may produce 
code, affect the listing, or change the state of the 
assembly. 


Directives may appear anywhere in the assembly source 
program, except for the END directive which must be the last 
statement of the program. 


Each directive has a unique syntax. 


Program Sections 


Each source program processed by the Assembler-16 consists 
of one or more program sections (PSECTS). They are defined 
by the ASECT, DSECT and RSECT directives. 


The ASECT directive defines the absolute section; there is a 
maximum of one. The RSECT defines a relocatable section; 
there may be zero or more relocatable sections in a program, 
but only one per assembly. The DSECT directive defines a 
dummy section; there may be zero or more dummy sections in a 
program. Note: no object is output for a DSECT. 


A section of code is delineated by section directives. Code 
in the source program following a section directive belongs 
to the directive-defining section until another section 
directive is encountered. 


Sections may be named or blank. Each named, relocated 
section is assumed to be independently relocatable from all 
other relocatable sections which are blank or named 
differently. 


Only one blank (unnamed) relocatable section is recognized. 
RSECT directives with different names define different 
sections. The name of a section may not match the name of 
any other section of a different type. 


Absolute (ASECT) section is used to generate non-relocatable 


code or data references. Addresses of data or code inside 
an absolute section cannot be altered by the linker or 
loader. It is recommended, therefore, that ASECT sections 


precede RSECT sections when coding. 
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Relocatable (RSECT) sections are used to produce object code 
which is relocatable by the linker or loader. 


DSECT (dummy section) is used to generate absolute offsets. 
No: Ob 3ece: 15 output for 2 DSECT. 


If neither an RSECT, DSECT, or ASECT statement begins an 
assembly, the blank (unnamed) RSECT is assumed. 
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ASECT 
Absolute SECTion 


[global label] ASECT 


Opens an absolute segment and sets the current location 
counter to zero. Code assembled in the absolute segment may 


not be relocated by the linker or loader. 


The label, if any, is defined at the current location 
counter after the segment is opened. 


Example: 
MAIN ASECT 


defines the beginning of an absolute segment with the name 
MAIN. 
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RSECT 
Relocatable SECTion 
[global label] RSECT 


A relocatable segment is opened with the name defined by the 
label, if present, with the location counter initialized to 


ZELO.% 


Example: 
SORT RSECT 


defines the beginning of a relocatable segment with the name 
SORT. 


Radie Shaek 


284 


ASSEMBLER-16 DIRECTIVES 
TRS-8SO ° 


DSECT 
Dummy SECTion 
[global label] DSECT 
Opens a dummy segment with the name defined by the label, if 
present, with the program counter initialized to zero. 
Example: 
EQUATES DSECT 


defines the beginning of a dummy segment with the name 
EQUATES. 
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ORG 
ORiGinate program 
ORG exp 


Sets the current location counter to the value defined by 
the expression. The current program section is not changed. 


If the current program section is absolute, the expression 
must be absolute. 


If the current program section is relocatable, the 
expression must evaluate to relative to this section. 


The expression must be pass-one defined. In an absolute 
section, exp is the address of the beginning of the ASECT. 
In a relocatable section, exp is the number of bytes between 
the RSECT and a preceding section (if there is one) or 
between @ (if no preceding section). 

Example: 


ORG H'ASVP 


sets the current location counter to H'AGQD. 
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RES 
REServe 


[label] RES[m] exp 
where 

n= 8). WwW, bor null 
Increments the current location counter by the number of 
bytes specified by the length indicator and the value of the 
expression. The length indicator, m, defaults to W. When m 
is Wor L, the PC is set to an even number before the space 
is reserved by incrementing by 1 if PC 1s odd. 


Defines the label at the current location counter (even 
boundary if m = W or L). 


The expression must be a pass-one defined absolute value. 


Example: 
TABLE RESW 109 


reserves a block of memory which is 29% bytes long, the 
first byte of which is known as TABLE. 
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EQU 
EQUate 


global label EQU[m] exp 

or 
global label EQU[m].register 

where 
m= B, W, L, U or null 
Defines the label to take on the value of the expression or 
register in the operand field. If the length indicator, m, 
is specified, then the label takes on that length attribute. 
If the length indicator is absent, the label assumes the 
length attribute of the expression or the register symbol. 


The expression must be pass-one defined. 


Example: 
SLASH EQU ued 


equates the word SLASH with the code for "/". 
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END 
END of program 


[label] END [exp] 

Defines the label, if present, at the current location 
counter. The END directive is the last valid statement in 
the assembly. An error message is output on every source 
line after this. 

If an end-of-file on input is reached prior to an END 
statement, a warning message is generated, and an END record 
is assumed. 


The optional expression operand defines the entry point 
address, to which control is transferred after loading. 


Note: When several programs are linked the exp is taken 
from the last program included. 

Example: 

FINISH END ENTRYL 

defines the end of the program to be here, at statement 


label FINISH, and defines ENTRY1 to be the entry point of 
the program. 
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TITLE 
TITLE of page 


TITLE ‘string’ 
"string" 


Causes a new page on the listing output, and the character 
string is set in the subheader of each subsequent page of 
the listing. 


The character string should not be packed. It should begin 
and end with matching quotes, either single or double. 


The TITLE directive is the first line past the page header 
on the new page. 
Example: 

TITLE "DATA FORMAT ROUTINE' 


causes a new page to be printed, and the heading "DATA 
FORMAT ROUTINE" to be printed at its top. 
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PAGE 
new PAGE 


PAGE 


Causes a new page on the listing output. The PAGE directive 
is the first line past the page header on the new page. 


Example: 
PAGE 


causes a new page to be printed. 
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and stores them in 
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indicator is given, 
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DATA 
define DATA 


DIRECTIVES 


associated with the operand expressions 
consecutive memory locations. Each 

a byte, word, or long word depending on 
the length indicator: B, W, or L respectively. If no length 
default 1s W. If W or L is specified, 
the PC is adjusted to an even boundary before generation of 
data. The optional label takes on the value of the current 
location counter after adjustment (if any). 


The length attribute of the label is set to B, W, or L 
according to the length indicator. 


If the value is too large for the specified field, it is 
truncated and a warning is generated. 


Example: 


POWER 2 DATAB 


Ll, 274/816 


fills 5 bytes beginning at location POWER2 with the numbers 


given. 
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RDATA 
Repeat DATA 


[label] RDATA[{m] expl, exp2 
where 
m= B, W, or null 


Computes the value associated with the operand expression 
exp2 and stores it in 'expl' consecutive memory locations. 
Each exp2 occupies a byte, word or long word depending on 
the length indicator (B, W, or L respectively). If no 
length indicator is given, the default is W. If W or L is 
specified, the PC is adjusted to an even boundary before 
generation of data. The optional label takes on the value 
of the current location after adjustment (if any). 


The length attribute of the label is set to B, W, or L 
according to the length indicator. 


If the value is too large for the specified field, it is 
truncated and a warning is generated. 


Note: expl must be a pass-one defined absolute value. 


Example: 
TABLE2 RDATAL 199 ,9 


defines a 49M byte area of memory as TABLE2 and fills it 
with zeroes. 
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TEXT 
TEXT string 


[label] TEXT 'string' 
"string" 

P'string' 

P"string" 


Stores the operand character string in memory in either 
unpacked or packed format. In unpacked format, the string 
operand begins with a quote (single or double). 


Two consecutive quotes inside a character string represent 
one quote character as part of the string. Characters are 
stored one ASCII, zero-parity character per byte. In packed 
format, the characters are first encoded and then packed, 
modulo 49, three characters per word, occupying an integral 
number of words with blank fill on the right as necessary. 
The packing algorithm encodes the characters as: 


letter f( letter) 


Z, 1-26 
-9 27-36 
$ a7 
- 38 

39 
all others g 


A 
g 


These encoded letters are packed three to a word by setting 
the word equal to: 


((£(C1L)*49+£(C2))*49)+£(C3) 


where multiplication and addition employ unsigned 16-bit 
arithmetic. 


If a label is present, it is defined at the current location 
counter, with a length attribute of B. 


Null character strings are valid, no output being generated. 


Example: 


MSG1L LEAT "INSERT NEW DISK' 
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defines a block of memory called MSGI and fills it with the 
String, 
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TEXTC 
TEXT string with Count 


[label] TEXTC 'string' 
"string" 

P* string’ 

P"string" 


Stores the characters of the operand as in the TEXT 
directive, preceded by a count of the number of characters 
in the string. 


If the string is packed, the count occupies one word. If it 
is unpacked, the count occupies one byte. 


If a label is present, it is defined at the current location 
counter with a length attribute of B. 


Null character strings are valid, a one-word count of 9g 
being generated. 

Example: 

LINEIN TEXTC 'STRING LENGTH’ 


defines a block of memory call LINEIN and fills it with the 
string, the first element being the string length. 
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REF 
REFerence external symbol 
global label REFm 
where 
m= B, W, L_ or null 
The required label is declared to be an external symbol with 
a length attribute as defined by the length indicator, m. 
If no length attribute is specified, the default is W. All 
references to label in code-generating instructions will be 
updated by the linker. This restricts the complexity of 
expressions in which a label may appear to that which is 
manageable by the linker. 


The reference is assumed to be a relocatable address. 


Example: 
USERIL REFW 


declares the word variable USER1 to be an external variable. 
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DEF 
DEFine external symbol 


DEF symboll[,symbol2[...,symboln] ] 

The symbol(s) are declared to external symbols which are 
defined within this module. The symbols must be global 
labels, and may be either absolute or relocatable. Symbols 
must be DEFined in order to REFerence them from other 
modules. 

FORM symbols and user-defined op code directives cannot be 
DEF'd. Symbols that are external (i.e., declared by REF) 
cannot be DEF'd in the same assembly. 

Example: 


DEF ENTRYL, ENTRY2 


defines ENTRY1 and ENTRY2 to be external labels defined 
Within. the cucrert, 
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COPY 

COPY filename 
COPY filespes 
where filespec is any valid TRSDOS-16 file specification 
consisting of filename and extension (no password, drive 
number, or diskname). 
Copies the source file specified by filename into the input 
stream after this COPY statement and before the next 
statement in the normal input stream. 
There is a maximum of nine COPY statements in the assembly. 
No nesting of COPY statements is allowed. 
Example: 


COPY STDIO 


copies the file STDIO into the current location, in the 
program. 
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FORM 
FORMat definition of data 


global label FORMm expl[,exp2[...,expn]] 
where 
m= B, W, L or null 


The FORM directive enables the user to define bits of data. 
The global label is defined to be a FORM-symbol (mnemonic). 
A FORM-symbol (mnemonic) must be defined by the FORM 
directive before it is referenced in a program. 


The operand expressions (exp) specify bit-field sizes. They 
must be absolute and pass one-defined, and the sum of the 
expression values must be 8, 16, or 32 as the length 
indicator, m, is: B, W, or L respectively. If no length 
attribute is specified, the default is W. Each expression 
defines the number of bits occupied by a field in the 
generated user instruction which employs this form. Up to 
32 fields may be defined for m = L; up to 16 fields may be 
defined for m = W; up to 8 fields may be defined for m = 8. 


The first expression, (exp) describes the high-order bit 
field of the generated object data; the second (if any) 
expression the next contiguous field; .... until m is 
filled. 


Example: 

X 4X12 FORMW 4, 12 

describes a word with two fields of 4 (high order) and 12 

bits reSpectively. X4X12 can then be used as a mnemonic 

(Formal Symbol) to generate a word format as follows: 
LabelA X4X12 3 H'39@ 

where the bit fields will be #9M11 and PH1L1GIOPPGHWD: the 


first field is filled with a decimal 3 and the second with a 
hex 309. 
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Extended Use of FORM-symbol (second level directive) 


global label FORM-symbol expl[,exp2[...,expn]] 


The global label (second level mnemonic) is defined as yet 
another code-generating Assembler instruction. The code 
generated by a second level mnemonic is byte, word, or long 
word (depending upon how the FORM-symbol was defined.) 


Note: The FORM-symbol must have been previously defined in 
a FORM directive. 


The number of expressions appearing as operands must match 


the number of bit fields defined in the FORM directive. Each 
expression may contain reference parameters (&l, &2 ...,&n). 


When a second level mnemonic is used in source code its 
operands replace the reference parameters (&l, &2...,&n) of 
the second-level directive. The data generated are the bit 
fields defined by the new expressions list. 


With the earlier Example: 
X4X12 FORMW 4,12 

you can create a second mnemonic: 
SECLEV X4X12 3, &1+H'29 


The global label (SECLEV) becomes the second level mnemonic, 
used as follows: 


[label] SECLEV H'309 


where the operand H'3@M replaces the reference parameter &l. 
The resulting data (bit fields) would be: 3, H'39@+H'2@ or 


PP11 PH11PP1PPPPD. 


Note: The sizes of bit fields (4, 12) were given in the 
FORM directive. 
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PRIVILEGED INSTRUCTIONS 
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As was said in an earlier chapter, the MC689%@ 
microprocessor has two modes of operation: the user mode, 
and the supervisor mode. This chapter deals with the 
additional instructions generated by the Assembler-16. They 
are available in the supervisor mode and are called 
"privileged" instructions. 


The TRSDOS-16 Operating System works in the supervisor mode. 
However, in order to protect itself it does not permit the 


user to enter this mode. Therefore, there is no way to 
enter the supervisor mode while operating under TRSDOS-16. 
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AND 
AND status register 


AND[1] .SR, #exp[.W or .L] Operand length(1): B, W 
Performs a logical AND on the immediate expression (#exp) 


and the status register (SR), and stores the result in the 
status register. 


Example: 
If the SR contains H'2@15, then 


ANDB -SR, #H'F6 


changes the contents of the SR to H'2914. 


Condition Codes: 


Re ee 


All of the flags are set according to the operation. 


Instruction Field: 


ee ieee ee OL ee a ee I eae 
SG F F F FY FF 1 GF} size | mode | reg. | 
word data (16 bits) 


The size field contains the size of the operation. 
Tf the size field is #@M, it is byte. 
If the size field is 91, it is word. 
If the size field is 1%, it is long. 


The register and mode fields contain the destination 
(status register) 111 199. 


The word data field contains #exp. 
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LD 
LoaD status register 


LD[1] Destination source Operand length(1l): W 
LD[1] .SR, #exp[{.Wor .L] 

-SR, —-@As 

-SR, @As+ 

-SR, /exp[.W or .L] 

-SR, [exp]@As[ (Ri) ] 

-SR, exp[@PC[(Ri)]] 


Loads the contents of the source (second) operand into the 
status register (SR). The source operand is a word. All 
bits of the status register are affected. 
Example: 
If the SR contains H'2319, then 

LDW -SR, #H'2915 


changes the contents of the SR to H'2Q15. 


Condition Codes: 


ee oN Se. Oe 


All flags are set according to the source operand. 


Instruction Field: 


BG ode a ae A oO hs es oR ei 
Go 2 We odes rege | 


The register and mode fields contain the address of 
the source operand. 
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MOV 
MOVe status register 


MOV[1] Destination, Source 
MOV[1] .SR, .Ds Operand length(1): W 
Moves the contents of a data register to the status 
register. 
Example: 
If D@® contains H'2915, then 

MOVW JbRy .De 


changes the contents of the SR to H'2@15. 


Condition Codes: 


He 6 re en 


All of the flags are set according to the source operand. 


Instruction Field: 


D520 e os A 7 Ge eB 
Os ee, Pd a mode il reg. 


The register and mode fields contain the source data 
register. 
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| MOV 
MOVe user stack pointer 


MOV[1] Destination, source 
MOV[1].Ad, .USP Operand length(1l1): L 
~USP, «AS 


Moves the contents of the user stack pointer (USP) to or 
from an address register. 


Example: 
If the USP contains H'@GUFF PVIH, then 


MOVL .AZ, .USP 


changes the contents of AM to H'GUFF PIIP. 


Condition Codes: 


: pe ee a ae, © 


None of the flags are affected. 


Instruction Field: 


Popa aa es as I noes a ee 
GT de 8 ee) reg. 


The direction field contains the direction of the move. 
Tf the direction field contains @, the contents of the 
user stack pointer is moved from an address register. 
If the direction field contains 1, the contents of the 
user stack pointer is moved to and address register. 


The register field contains the address register number 
used in the operation. 
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OR 
inclusive OR status register 
OR[1] -SR, #exp[.W or .L] Operand length(1l): B, W 
Performs a logical OR on the immediate expression (#exp) and 
the status register (SR), and stores the result in the 
status register. 
Example: 
If the SR contains H'2915, then 
ORW .SR, #H'ASGD 


changes the contents of the SR to H'AQ@15. 


Condition Codes: 


A Ne VS 


All of the flags are set according to the operation. 


Instruction Fields: 


Eo: ve oe I Ae Gn BOs. ee ee os 


9 8 
GS GF BF PC GF BF YF F |size| mode | _ reg. 
word data (16 bits) 


The size field contains the size of the operation. 
If the size field is 99, it is byte. 
If the size field is 91, it is word. 
If the size field is 1%, it is long. 


The register and mode fields contain the destination 
status register. 111 199 


The word data field is the expression. 
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RESET 

RESET external devices 
RESET Operand length(l): unsized 
Resets all external devices. The processor state, other 
than the program counter, is unaffected and execution 
continues with the next instruction. 
Example: 
If the PC contains H'69%4, then 


RESET 


resets all external devices and increments the PC to H'60@6. 


Condition Codes: 


© oN 2 VS 


None of the flags are a affected. 


Instruction Field: 


Se Ses Se Sa Sy OS ee me: Un Sa es ee eee a 
ee ed 
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RETI 
RETurn from Interrupt 
RETI Operand length(1l): unsized 
Pulls the status register (SR) and the program counter (PC) 
from the system stack. The previous status register and 
program counter are lost. All bits in the status register 
are affected. 


Example: 


If the SP points to memory address H'6@@M which contains 
H'@Y 15 OY OH FM PP, then 


RETI 
changes the contents of the SR to H'#M#15 and the PC to 
H' FOOD. 
Condition Codes: 


me Ne ae 


All of the flags are set according to the content of the 
word on the stack. 


Instruction Field: 


1. Sale SO we = Le ok By a) 2 
Dg 1 g g 1 a ee ee es ae a ae 
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WAIT 
WAIT for interrupt 


WAIT #exp[.W or .L] Operand length(1l): unsigned 


Moves the immediate operand (#exp) into the entire status 
register (SR). The program counter (PC) is advanced to the 
next instruction, and the processor stops until an 
interrupt, reset or trace occurs. 


A trace exception will occur if the trace state 1s on when 
the WAIT is executed. If an interrupt request arrives with 
a priority higher than the current processor priority, an 
interrupt exception occurs. If the bit corresponding to the 
S-bit of #exp is off, execution of the instruction will 
cause the privilege violation. External reset will always 
initiate reset exception processing. 
Example: 
If the SR contains H'2911, then 

WAIT #H'2015 
changes the contents of the SR to H'2915 and stops all 
processing until an interrupt is received. 


Condition Codes: 


ae: See eee ee, © 


All the flags are set according to #exp. 
Instruction Field: 


Epp eS ce lek, 


The #exp field contains data to be loaded in the status 
register. 
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XOR 
eXclusive OR status register 

XOR[1] .SR #exp[.W or .L] Operand length(l): B, W 
Performs a logical eXclusive OR on the immediate expression 
(#exp) and the status register (SR), and stores the result 
in the status register. 
Example: 
IF the SR contains H'2915, then 


XORB SR, #H°1F 


changes the contents of the SR to H'2@@A. 


Condition Codes: 


me NS Se 


All the flags are set according to the operation. 


Instruction Field: 


1 eS TD A a oS Be 0 6 A ee 
eo Pd ete | mode”) reg. 
word data (16 bits) | 
The size field contains the size of the operation. 
T£ the size field is 99, it is byte. 


Te the sige field. is Pl, 22-18 word, 
TE the S136 trea 1s 10, ie 1s long, 


The register and mode fields contain the destination 
status register 111 199%. 


The word data field contains the #exp. 
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APPENDIX A/ Object Code Description 


The object code produced by the assembler-16 serves as input 
to a linker routine before being stored in memory. 


The object code defined here is designed to be compact and 
simple, yet capable of providing for future language 
extensions. 


GENERAL STRUCTURE 


The object code for a program is contained in a single file 
of sequential organization. The file consists of 
sequentially organized groups of data, called plexes, which 
may span record boundaries arbitrarily. 


Each plex contains a byte count as its first character. 
This limits the size of a plex to 255 characters. The byte 
count includes the character containing the byte count. 
Each plex also contains the plex type as its second 
character. Thus, the minimum size for an object code plex 
is two bytes. 


Symbols within the object code are of variable length. In 
conformance with the assembler-16 limit, a maximum of 45 

characters for each symbol is observed. Whenever a symbol 
appears in the object code, the first byte is a count, and 
the subsequent bytes contain the symbol in unpacked format. 


PLEX TYPES 
Define Processor (9) 
Byte(s) Contents 
g Plex size = ll 
y Plex type = @ 
2 Version = Q 
3 Language Processor = @ 
4 Maximum Symbol Size = 45 
5-196 Date 


The Define Processor (Plex Type @) group must be the first 
group of an object file. 
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The Version field refers to the version of the object code. 
Subsequent versions may make the prior versions obsolete 
and/or incompatible. The linker can use this information to 
Support selected versions. 


The Language Processor field contains a zero for the 
assembler-16 - other language processors will be assigned 
other numbers. 


The Maximum Symbol Size in the object code is Gurrentiy 45. 
The assembler-16 removes all blanks from symbols. 


The Data refers to the date of object file creation. Date 
is ASCII in the form YYMMDD. 


Define Program Section (1) 


Byte Contents 

Gg Plex Size 

- Plex Type = l 
2-3 Section Number 
4-n Section Name 


This plex defines a section of code (Relocatable or 
Absolute) by name and by number. Subsequent reference to 
this section will be by number alone. The section number is 
unique for each differently named RSECT. An unnamed RSECT 
1s given the number 1, and the ASECT is given the number Q@. 


Section Name may contain a blank symbol of length 1 (to 
signify unnamed RSECT or ASECT); otherwise, it is the name 
given to the RSECT or ASECT assembly language program. 


The effect of Define Program Section in the linker is to 
select the section as the current section and to set the 
location counter to zero, 


Select Section (2) 


Byte Contents 
g Plex Size = 4 
wt Plex Type = 2 
2-3 Section Number 
® 
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This plex selects a section to be the "current" section for 
subsequent object code groups. Only one section can be 
current at any point in the object code. 


Another effect of the Select Section is to quiesce the 
previously current section. The program location counter of 
the quiesced section is not changed by the occurrence of 
this plex. 


The location counter previously current when this section 
was last quiesced becomes the current location counter. 


Select Section ORG (3) 


Byte Contents 

4) Plex Size = 8 

1 Plex Type = 3 

2-3 Section Number 
4-7 Displacement 


This plex selects a section as current and sets the program 
location counter to a value relative to the beginning of the 
section. 


| The Displacement is a 32-bit number which defines the value 
| of the new location counter for the section specified. The 
Displacement is relative to the start of the section. 


| Define Section Length (4) 


| Byte Contents 

| g Plex Size = 8 
| i Plex Type = 4 
| tat Section Number 
| 4-7 Section Length 


This plex type defines the size of the referenced section 
(in bytes). Only one of these plex types per section is 
permitted, and there must be one for each relocatable 
section defined. This is not required for ASECT. 


Define Symbol (5) 


Byte Contents 
4) Plex Size 
it Plex Type = 5 
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2-3 Section Number 
4-7 Value 
8-n Symbol 
nek. ss More definition groups 


This plex defines the value of a symbol. 


The Section Number identifies the section relative to which 
the symbol is defined. If the definition is an absolute 
number, the Section Number should be zero. 


The Value is 32 bits long and contains an offset from 
section start if Section type is relocatable, or an absolute 
number if Section type is absolute. 


The (Section Number, Value, Symbol) group may be repeated 
within the plex to define arbitrarily many symbols. 


Declare Symbol Reference (6) 


Byte Contents 

g Plex Size 

as Plex Type = 6 

a3 Symbol Number 

4-n Symbol 

ee es More reference groups 


This plex declares a symbol as an external-referenced name 
and assigns a number to it for subsequent usage in an object 
code expression. 


The Symbol Number is a two-byte binary value, which is 
unique to this symbol among all symbols in this program 
file. This number is used in object code expressions to 
reference the symbol value. 


As many (Symbol Number, Reference Size, Symbol) groups as 
necessary may follow the first such group. 


Load Constant Data (7) 


Byte Contents 

4) Plex Size 

1 Plex Type = 7 
Zn Date 
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This plex loads data at the current location counter and 
increments the location counter by one for each data byte 
loaded. 


Load Constant Repeat Data (8) 


Byte Contents 

g Plex Size 

Ng Plex Type = 8 

Z=D Repeat Count 

o-n Repeated Constant 


This group loads repetitious data values into memory at the 
current location counter. The value to be repeated may be 
any number (>) of bytes as computed from the size of the 
plex. The pattern is repeated the number of times specified 
in the repeat count. This can be used to repeat bytes, 
words, longwords, text strings, etc. 


Load Data with Reference (9) 
Byte Contents 


Plex Size 
1 Plex type = 9 
2 Modifiable Field Start 
3 Modifiable Field Size 
4 Skeleton Data Size 
5-n Skeleton Data 
(n+1)—-m Object Code Expression 


This plex loads data at the current location counter after 
evaluating an object code expression, including the result 
as part of the data. 


The data to be loaded may be a byte, word, or longword. 


The Modifiable Field Start is the bit number (9-31) within 
the Skeleton data where the modifiable field begins. The 
Modifiable Field Size gives the number of bits in the 
modifiable field, contiguous from Modifiable Field Start. 


The Skeleton Data Size is 1, 2, or 4 for Byte, Word, or 
Longword respectively. The Skeleton Data contains the data 
value to be loaded (1, 2, or 4 bytes). 


The Object Code Expression consists of a byte count followed 
by Polish notation for an expression to be evaluated by the 
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linker, the result of which is stored in the modifiable 
field of the data word. The byte count includes itself. 


The object code expression polish consists of operands and 
operators combined according to the following rules: 


The polish is in the form: 


<operand> 
or <binary operator><operand><operand> 
or <unary operator><operand> 


The <operand> may itself be the polish for an expression, or 
it may be: 


- a binary value 
- an address 
- the value of an external symbol 


If the <operand> is the polish for another expression, then 
the first byte must be an operator. The Operators are, 
therefore, numbered from 128 onward to distinguish them from 
operands. The values for the defined operators are given 
below. 


Operands may occupy one or more bytes, dependent upon the 
operand type. The first byte of each operand is the type 
byte. Subsequent bytes define the value associated with the 
operand (if any). 


Operand Byte 
Type | Length | Meaning 
| 
4) > Binary value 
I 7 Address 
5 External Symbol 


Contents of extra bytes in operand are: 


4 bytes 32-bit value 

2 bytes section number, 
4 bytes offset 

2 bytes symbol number. 


Binary value : 
Address : 


External Symbol: 


Operator Values and Types 
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Operator Value Type 
- 128 unary 

- 129 binary 
+ 139 binary 

* Be i binary 
jf L32 binary 
~AND. Lo binary 
XOR. 134 binary 
sOR< Loo binary 
NOT. 136 unary 
4 Orbis 13:7 binary 
-6HR% 138 binary 


The expression is evaluated using 32-bit values and 
accumulators. 


The result must "fit" into the Modifiable Field. Sign 
extension is permitted; if the resultant value X is in the 
range: 


n-l n-L 
-2 -l a me ee 


where n = number of bits in modifiable field. 
Then x is considered to "fit". 


Declare Program Entry Point (19) 


Byte Contents 

4) Plex Size = 8 
1 Plex Type = 19 
2-3 Section Number 
4-7 Entry offset 


This plex defines the entry point of the program, to which 
control is passed when loading is complete. 


End of File (255) 
Byte Contents 


g Plex Size = 3 
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1 Plex Type = 255 Y 
2 


Brror Indicator 


This plex terminates the program, closes all sections, and 
Signals the end of the file. 


The error indicator byte signifies what diagnostics were 
generated by the assembler-16. 


® = clean assembly 
4 = warnings generated 
8 = errors generated 
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BEGINNING OF --> -----3r3r rrr rrr rrr 
MEMORY 


7 


RUNCOBOL 
IF LOADED 


BASE ADDRESS --> -rrrrrrrrr rrr rrr 


USER 
MEMORY 


BOUNDS ADDR --D> ---3-3-r3rrrrrrrrrrr 


User memory begins at H'5@#@@ if the Debugger is not configured 
and at H'69@@ if the Debugger is configured. 
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APPENDIX C/ SAMPLE PROGRAMS 
PROGRAM 1: Simple 16 Bit Binary Addition 
This program adds the contents of one memory word (NUML) to 
another (NUM2), and stores the result in a long word (SUM). 
RSECT 
NUML DATAW H'1@FB 
NUM2 DATAW H'FF17 
SUM RESL x 
* 
BEGIN CLRL Dg Clear D@ 
LDW -DM, /NUM1 Put the word at NUM1 into D@ 
ADDW -Dg, /NUM2 Add the word at NUM2 to D@ 
STL -Dg,/SUM Store the long word at SUM 
END BEGIN 
After execution of this program, the number H'@#9G1 1912 is 
stored in the memory location associated with SUM. 
PROGRAM 2: BCD Addition WwW 
This program adds two binary coded decimals (BCD's) stored 
in NUM1 and NUM2, and stores the result in a third memory 
location SUM. (Note: Remember that all BCD arithmetic is 
byte size only!) 
RSECT 
NUM1L RESB Z 
NUM2 RESB ud 
SUM RESB i 
* 
BEGIN CLRL .Dg 
LDB -DZ,/NUM1 Load the number at NUMI1 into Dg 
LDB -D1,/NUM2 Load the number at NUM2 into Dl 
ADDD 0. gene BNE Add the two numbers 
STB .Dg,/SUM Store the resulting byte in SUM 
END BEGIN 
PROGRAM 3: Search a Table 
® 
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This program searches a TABLE for an ITEM. The word size 
elements of TABLE are arranged in ascending order, with the 
first word being the number of elements in the TABLE. If 
the ITEM is found, its number in the TABLE is returned as 
ITEMNO. If no match is found, then ITEMNO is set to H'FF. 


tabs bt ied 

ITEM RESW 1 

TABLE DATAW G? 5) "98715 7H'35;0' 40 FS 

I'TEMNO RESB i 

* 

BEGIN LDL .AZ,#TABLE Put start address of TABLE in A@g 
LDW -DP,@AD+ Put number of elements in D@ 
ADDL .Ag,.Dg Point AM 1 word past last elementof 
ADDL -AD,.DP of TABLE (twice since word=2 bytes) 
SUBW 00,4. Setup D@ for DB instruction 
LDB .D2,#FF Assume that no match will be made 
LDW lL, /LTEM Put ITEM into D@ 

LOOP CMPW .D1,-@AY Check element pointed to by AM; if 
DBGE .D@,LOOP D@ <> -l and Dl < element, continue 
BNE DONE If not equal then branch to DONE 
MOVB ~D2, 2D Else move element number to D2 

DONE STB .D2,/ITEMNO Store element number in ITEMNO 
END 


If ITEM equals H'15, then after execution of the program, 
ITEMNO contains H'@2: if ITEM equals H'36, then ITEMNO is 
set to HPF. 


PROGRAM 4: Convert ASCII to binary 


This program converts an ASCII coded decimal to its binary 
value. The program has two basic steps, first, conversion 
of the ASCII coded decimal into a binary coded decimal, and 
second, conversion of that BCD into its binary equivalent. 
Step 1 is accomplished by subtracting #H'3@ from the ASCII 
number (for exanple, the ASCII code for 7 168. H"37, so." 32 >= 
H'308 = H'@7). To accomplish step 2, we simply multiply the 
BCD by a power of 19 based on its position in the ASCII 
String. 


ASECT 
ORG H' 4999 
ASCINT RESL 1 
HEXNUM RESW a3 
* 
® 
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BEGIN CLRL re BY Clear the sum register (D2) 
LDL -DG,#1 Set initial power of 1% to l 
LDA -AY ,ASCINT+4 Put address of 4 past ASCINT in A@ 
LOOP LDB .D1,-@AG Get byte of ASCINT(start from left) 
SUBB -D1L, 4H ' 39 Convert to BCD 
MULU sDL, «DE Multiply by power of 19 
ADDL PZ plod Add product to sum 
MULU Dg, #19 Raise D@ to next power of 19 
CMP -AM,#ASCINT Check to see if at leftmost byte 
BNE LOOP If not, then continue 
STW -D2,/HEXNUM Else store sum in HEXNUM 
END BEGIN 


Tt ASCINT contains “L245™ (coded: B'S) 32: 34.35), then at the 
end of the program, HEXNUM contains H'@4DD. 


PROGRAM 4A: Program 4 as a subroutine 


Program 4 represents a commonly used routine. For example, 
after inputting a number with the KBLINE SVC, you might need 
to perform an arithmetic operation with it. But to use it, 
you must first convert the ASCII code, which the Svc 
returns, to a binary number, which the computer uses. 


In this example, the subroutine requires that a KBLINE SVC bd 


has just been executed successfully. The subroutine 
processes the number just as in Program 4, and returns the 
binary number to the calling program by putting it at the 
top of the user stack (A7). 


(Note: The 6899% limits multiplication to single word 
operands; however, to convert a large number, we need power 
of ten which takes up more than one word. To overcome this, 
we Simply treat the multiplicand, i.e., the power of ten, as 
two separate words. 


We then multiply the BCD by the low word, store it, and then 
shift the high word into the low word. The BCD is again 
multiplied by this word, but before we add it to the 
low-word-product we shift it back to the high word. 


For simplicity's sake, we limit the input number to less 
than 9 characters, so that we keep the shifted high word 
product in one register. However, if you need to convert a 
longer number, then you may use more than one register to 
contain the operands and the product. 
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*Subroutine ASCII TO HEX 
* 


* Purpose 


* 
* 


Convert an ASCII string to its binary mumberic value. 


* Entry Conditions 


* 
* 


An ASCII string has been entered via the KBLINE SVC. 


* Exit Conditions 


* 
* 


The converted string is put onto the top of the stack. 


* Limitations 


* 


Oo y 


The value of the ASCII string must lie between -9,999,999 and 
699,099... Tf the string 46 too large, or if 2e contains a non- 


numeric character (other than a leading minus sign), the subroutine 


* 
* 
* returns H'8909 WPVM to the stack. 
* 


ASCIT TO. ABA 


NEAT 


STML Di. DLY Doss D3 2.D4y.0S¢chL, nap eR *Save registers 
LDW D5 jae. *Put shift value into D5 

LDW .D4,12@A9d *Get length of input string 

CMPW .D4,H'99 *Check for too big 

BGT ERROR *If too big then branch 

SUBB .D4,#H'G1 *Else continue; correct for DBC 
CLRL 03 *Clear out sums register 

LDL .Al,#POWERS *Al points to POWERS 

ies .A2,8@AG *A2 points to buffer from SVC call 
ADDW .A2,12@AG9 *A2 points to 1 byte past buffer 
CMPW 14@AG,#H'@D *Check last character for CR 

BNE NEXT CHARACTER *Tf not, then branch 

SUBL A2,#H'G@1 *Else correct length 

SUBB .D4,#H'G@1 *Correct counter 

CHARACTER 

LDB .D%,-@A2 *Take a byte of the string 

SUBB DP, #H' 39 *Convert ASCII to BCD 

BN NON NUMERIC *If negative result, then branch 
CMPB .DP,#H' M9 *Compare with high bounds 

BGT ERROR *If greater than 9, then branch 
LDL .D1L,@Al+ *Get current power of 19 

MOVL mo are “Copy Dl 18. D2 

MULU i ge *Multiply the BCD by a POWER 
ADDL Pu ee geaey 8 *Put product in sums register 
SHRL ,DLyeD5 *Move high word to low word 

BE NO HIGH kif Hp? = 8, then pDrancn 

MULU sDepe be *Multiply the BCD by high word 
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SHLL D024 6D5 *Shift low word back to high word 
ADDL cD3-¢<«D2Z *Add product to sum register 
* 
NO HIGH 
DBC ~-D4,NEXT CHARACTER *If more numbers, then branch 
BR SUB DONE *Else branch to SUB DONE 
* 
NON NUMERIC 
ADDB DG, #H'39 *Convert BCD back to ASCII 
CMPB .D@,#H' 2D *Check for negative sign code 
BNE ERROR *If not right code, then branch 
CMPB .D@,#H' 2D *Make sure it's the lefmost byte 
BNE ERROR *If not, then branch 
NEGL <3 *Else take negative of sum register 
BR SUB DONE *Branch to SUB DONE 
* 
ERROR 
LDL .D3,#H' 8990900 *Error code is H'8@9o PIGG 
* 
SUB DONE 
STG ~.D3,H'24@A7 *Return result to stack 
LDML -OO MD. D2 3D ses COS ye Al eA Ben + *Restore reg's 
RET *ReEturn to calling routine 
* 
POWERS WS 
DATAL 1,109,199 ,1999 , 19999 , 199909 , lOO OD 
DATAL 1PPIIPOY , 1\PVIIPOOS ,1VI RRO ROO 
Note that the first thing we did was save the contents of 
the registers which the subroutine altered. The STM and LDM 
instructions, in combination with pre-decrement and 
post-increment indirect addresssing work well for this since 
the STW instruction stores from the lowest address register 
to the highest data register, while the LDM instruction 
loads in just the opposite order. 
PROGRAM 5: Converting Hex to ASCII Integer 
The last program described how to convert an ASCII integer, 
presumably entered from the keyboard, into its binary (or 
hex) equivalent. It is also important to be able to do the 
opposite--convert the binary to ASCII integer, so that it 
can be sent to a display. | 
To accomplish this, we basically need to run Program 4 in 
reverse. That is, we can divide the binary number by powers | 
of ten to give the BCD value of each decimal digit. We then | 
| | 
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convert the BCD to ASCII by adding H'3@, and store the 
values in a string. 


However, as in Program 4A, we run into the problem of size. 
The 6899M can accept division of a long word by a single 
word, resulting in another single word. However, we may 
have some numbers which would result in a quotient longer 
than one word--this would give an overflow error. 


Because of this, we must perform the division by subtracting 
a power of ten, repeatedly (summing the number of times we 
subtract) until the difference is less than that power of 
ten. We then perform the same steps with lower powers of 
ten until the power of ten equals one. The number of the 
subtractions per power gives the BCD for that power. It is 
a simple matter, then, to convert the BCD string into an 
ASCII string by adding H'3M to the BCD. 


*Subroutine HEX TO ASCII 


* 
* Purpose 


= Convert a hexadecimal (binary) number into its ASCII-coded 
* decimal equivalent. 


* 


*Entry conditions 
* The value of the hex number is pushed to the stack, on top of the 
* destination address of the resulting ASCII string. 


* 


* Exit conditions 
* The ASCII string is stored in the memory address specified by the 
* calling program. 


* 
* Limitations 


* The hex number must evaluate to a decimal value between 


* +/- 19**9, 

* 

HEX TO INT 
STML 
LDA 
LDL 
LDL 
MOVB 
TESTL 
BP 
SUBW 
MOVB 
NEGL 


.Dg,.D1,.D2,.A0,.Al,-@A7 *Save registers 

.AZ ,POWERS 2 *Put address of POWERS2 in AQ 
Al,H'1S@A7 *Get address of ASCII INT off stack 
.D@,H'1C@A7 *Get value of hex number off stack 
@Al+,#H' 29 *Store blank for first character 
.Dg *Check hex number for sign 

NEXT POWER *IT£ positive then blank was correct 
<A ae OL *FElse move back to first character 
@Al+,#H' 2D *Put a negative sign there 

.Dg *Change the hex number to positive 
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NEXT POWER 
LDB .D2,#H' 39 "Set. D2 to ASCIT zero 
LDL -D1,@AM+ *Get next power 

* 

MORE SUBTRACTION 
CMPL DP, D1 *Check for done with that power 
BLT NEXT DIGIT *If done then branch out of loop 
SUBL ,De 2. DL *Else subtract power from hex num 
ADDB D2 ,48H'° Ol *and increment counter 
BR MORE SUBTRACTION *Continue subtraction 

* 

NEXT DIGIT 
STB ~.D2,@A1+ “Store counter in ASCII INT string 
CMPB SOLS OL *Check for last power 
BNE NEXT POWER *If not then do another power 
LDML ,De- Lg. De oe ON fe *Else restore registers 
RET 

* 

POWERS 2 


DATAL 1IPIPIVPIOS , 1\YVIVIVIS , 1\VPHPIIO ,1GVAVOO , 1B IOE 
DATAL 199,199,199 ,19,1 


Compare the Program 5 with Program 4A. Note that when we 
loaded the address of POWERS in Program 4A, we used a load 
address register immediate (LDL) instruction, while in 
Program 5 we used a load effective address (LDA) 
instruction. Either is correct. 


Also note that for Program 4A we ordered POWERS in ascending 
order and accessed the elements starting from the front, 
while in Program 5 we ordered POWERS2 in descending order 
and accessed the elements from back to front. Either is 
just as convienient since the 6899% has auto increment 
(@An+) and decrement (-@An). 


PROGRAM 6:Calling a subroutine 


Programs 4A and 5 were presented as subroutines. It was 
assumed that some other program supplied the subroutine the 
necessary parameters (like the address of ASCII INT, etc.). 
Here iS a sample showing what a main program which calls 
these subroutines might look like: 


*Data block 
* 

Roce 
HEXNUM 
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RESL ws 
SVC BLOCK 

RDATA 32,2 
BUFFER 

RDATA 89,2 
ASCII INT 

RESB 12 


* 


*Program block 
* 


TRS-SO * 


.A®,SVC BLOCK 
@AG,#H'G5 
6@A0,#H'D9 
8@A9,#BUFFER 
#9 

2@AG 

ERROR ROUTINE 
.A7,#H'@4 
ASCII TO HEX 
@A7,#H' 8990009 
ERROR ROUTINE 
@A7+,/HEXNUM 


/HEXNUM, -@A7 
ASCII INT 
HEX TO INT 
@AG,#H'P9 
6@A9,#H'MB 
8@A9,#H'PD 


19@AM,#ASCII INT 


#9 
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*Set up KBLINE SVC 


*Check for SVC error 

*On error branch to ERROR ROUTINE 
*Make space on stack for hex num 

*Call up ASCII TO HEX subroutine 

*Check for subroutine error 

*On error branch to ERROR ROUTINE 
*Pop hex number into HEXNUM 


*Push hex number to stack 

*Put address of ASCII INT on stack 
*Call up HEX TO INT subroutine 
*Set up VDLINE SVC 
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APPENDIX D/ The Configuration Command File 


Whenever TRSDOS-16 starts up or is reset, it-looks for a 
file named CONFIG16/SYS. This "configuration command file" 
tells TRSDOS-16 to link in certain extra operating system 
programs. 


CONFIG16/SYS should be present on the primary disk device 
(drive @ or drive 4). It contains these directives: 


INCLUDE RUNCOBOL 
INCLUDE DEBUG 
END 


which tell TRSDOS-16 to link in the RUNCOBOL program and the 
DEBUG program. 


You may create your own CONFIG16/SYS file, or modify the 
existing one to meet your needs, by using EDIT16. 


SAVING THE EXISTING CONFIGI16/SYS FILE 
Before creating a new CONFIG16/SYS file, you will probably 
want to save the existing one by renaming it. 
For example: 
RENAME CONFIG16/SYS:% TO DEBCOB/CFG:9 


renames the default configuration file. (The new filename 
tells you it includes both DEBUG and RUNCOBOL modules. 


After renaming the existing CONFIG16/SYS file, you can 
create a new one. 


Since you "saved" the existing file, you can use it again. 
To do this, rename the present CONFIG16/SYS file (if you 
want to save it) and then rename DEBCOB/CFG back to 
CONFIG16/SYS: 


RENAME DEBCOB/CFG:@ TO CONFIG16/SYS:9 
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TO EDIT OR CREATE CONFIG16/SYS 
Use EDIT16 to edit or create a CONFIG16 command file. 
ee Type: 
EDIT1L6 <ENTER> 
and the Editor's Command mode prompt will be displayed: 
Lo Ske Bt Ele ack ee OS ae ee Sia & Oe eS 


2% To insert commands into the command file, you must get 
in the Insert mode, type: 


IN <ENTER> 


The Editor will display the I? prompt, indicating that 
you are in the Insert mode. 


ay You are now ready to insert the names of the programs 
you want linked to TRSDOS-16. 


Comments may be used. They are indicated by an 
asterisk (*) in the first column. 


The key word INCLUDE tells TRSDOS-16 the 
name of the program. The syntax for the INCLUDE 
statement is: 

INCLUDE filename 
The default extension for filespec is /SYS; it is 
optional. Drive numbers, disk ID and Passwords are 
not permitted. 
Programs are loaded sequentially in memory in the order 
they are encountered in the CONFIG16/SYS file. The 
maximum number of programs that may be INCLUDEd is 15. 


The programs must be resident on the primary boot 
device (Drive @ or Drive 4). 


The list is concluded with an END statement. 
For example: 


* This is the Configuration File for DEBUG 
INCLUDE DEBUG 
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END 
tells TRSDOS-16 to link only the DEBUG program. The 
first line is a comment and is not executed by 
TRSDOS-16 
4, When you are finished inserting, type: 


! <ENTER> 


to exit the Insert Mode. 


De Save the file with the following command: 
SA CONFIG16/SYS <ENTER> 


6. You now have a new CONFIG16 command file that TRSDOS-16 
will use when it powers up or resets. 


CONFIGURATOR ERROR MESSAGES 


When the Configurator lists a line generating an error, it 
prints an error message directly underneath the line number. 
Preceding the message, it inserts three asterisks. 
In cases of certain syntax or file I/O errors, the 
Configurator also marks, with a dollar sign ($), where in 
the line the error occurred. 
For example: 

11 INCLUBE RUNCOBOL 

*** Tllegal Command 


shows a syntax error in the spelling of INCLUDE. 


There are three catagories of Configurator error messages: 


A. Configuration Control File Errors 
Bs Configuration Command Errors 
Ss Completion Errors 
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A. Congifuration Control File Errors 


These errors are FATAL. If one of these errors occur, the 
Configurator could not properly execute the CONFIG16/SYS 
file. TRSDOS-16 will still be displayed but certain 
defaults will have occured: 


i No programs have been INCLUDED 
eae DEBUG is kept resident (if available) 
a Any memory not occupied by DEBUG and the resident 


Operating System is available to the user. 
Use EDIT16 to correct the error (or create a new 
configuration file) and reset the system. 
Can't Open CONFIG16/SYS: TRSDOS Error Code = nnn 
Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 
Can't configure system: File CONFIG16/SYS not proper 


format 


The CONFIG16/SYS file is not a VLR type file. 


Can't configure system: File CONFIG16/SYS not found 


TRSDOS-16 could not find the CONFIG16/SYS file. 


I/O Error on File CONFIG16/SYS: TRSDOS Error Code = nnn 


Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 


B. Configuration Command Errors 


These errors occur when a command cannot be processed by the 
Configurator. If one of these error occurs, the 
Configurator will continue to process the command lines. 
However, the desired result of the configuration file may 
not have been accomplished. For example, an INCLUDE file 
may have been left out. 
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Can't INCLUDE program: TRSDOS Error Code = nnn 
The Configurator cannot load the program because 
of an I/O error. Look up the TRSDOS-16-Error Code 
in Appendix B. 

Can't INCLUDE program: Out of Memory 
More resident programs were requested than will fit 
into user memory. 


Can't INCLUDE program: Program already configured 


This error occurs any time a program is included twice. 


Too many INCLUDED programs: this request ignored 
This error occurs if more than 15 programs are 


included. The command line that is flagged is ignored 
(treated as a comment). 


Cx Completion Error 
*** CONFIGURATION ABORTED *** 
This message appears when the configurator could not 


finish processing the CONFIG16/SYS file because of 
an I/O error. 


ABOUT THE CONFIGURATOR 


The Configurator is invoked whenever the 689@M processor is 


initialized. It performs several important functions: 
‘ It determines whether the machine debugger is 
required. If not, it is eliminated from memory. 


This gives you an extra 4K of memory. 


; It initializes traps and interrupts. This 
eliminates the need to keep extra code resident 
in memory. 
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. It loads in resident programs as specified in 
the CONFIG16/SYS file. 


. It reads the AUTO file and passes it to 
TRSDOS-16 for execution. 


The Configurator is linked in at the end of user memory and 
occupies 4K of memory. Upon system initialization, it moves 
itself to the top of physical memory. This is because the 
resident programs will be loaded at low address, overlaying 
the original configurator. 


Next the Configurator begins to load the resident programs 
requested in the CONFIGI16/SYS file (i.e. DEBUG and 
RUNCOBOL). It loads these programs sequentially starting at 
the beginning of user memory and up to the beginning of 
where the Configurator has relocated itself. This 
guarantees that after loading is complete, the user has at 
least 4K of memory available (the size of the Configurator). 


After configuration is complete, the Configurator is no 
longer neccessary and is overwritten. . 
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APPENDIX E/ Additional 68999 Instructions 


The MC6899M microprocessor supports three opcodes in addition 
to those supported by the ASSEMBLER-16. These instrucions are 
BRanch Always (BRA), Branch to SubRoutine (BSR), and Test a 
Bit and Set (BSET). 


BRA 

BRA is very Similar to BR exp(@PC) in that it allows you to 
transfer control of your program unconditional to a PC 
relative address. The major difference between the two 
instructions is that the BRA instruction can use less storage 
Space when using an eight-bit displacement because it puts the 
displacement value in the same word as the instruction code, 
thus saving two bytes of storage spaces. 


The BRA instruction may also be used for sixteen-bit 
displacements; however, the displacement is stored in an 
extension word following the instruction field. Like the BR 
instruction, the BRA instruction affects none of the 
conditions codes. 


The instruction field for BRA is: 


LoS eo a ee a 8 2 A oe 


g a) . g 4) G6 go @ 8-bit displacement 
16-bit displacement 


For an eight-bit displacement, the second word (containing the 
Ssixteen-bit displacement) is not necessary. For branches 
using the sixteen-bit displacement, the eight-bit displacement 
field is filled filled with zeroes. 


BSR 

BSR is similar to the CALL exp(@PC) instruction, in that it 
allows you to call a subroutine whose start address can be 
given as a displacement relative to the program counter. As 
with CALL, the computer first pushes the address of the 
instruction following the BSR onto the stack. Also like CALL, 
BSR changes none of condition codes. 


The major difference between CALL and BSR is that the BSR 
instruction may only be one word long when an eight-bit 
displacement is specified. For a sixteen-bit displacement, 
two words are used, the second word holding the displacement 
value. 
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The instruction field for BSR is: 


5 a 6 Ay a TAL ee Bl 


4) 1 1 g 4) CG BO @ 8-bit displacement 
16-bit displacement | 


For an eight-bit displacement, the second word (containing the 
sixteen-bit displacement) is not necessary. For subroutine 
calls using the sixteen-bit displacement, the eight-bit 
displacement field is filled with zeroes. 


BSET 

BSET is similar to the other MC689@0@ bit-test instructions. It tests 
a specific bit of the operand, records the result in the zero bit of 
the condition codes, and then sets the specified bit. You may 
specifiy the bit-number (i.e., the number of the bit to be tested) 
either from a data register or as an immediate value. The instruction 
field for the former is: 


15 ea 1 2 eS Se 
ee : 


716 
OO Oe Re Se |e Reg 22 |. Medes 


where Rs is a data register containing the bit number. The 
instruction field for the immediate version is: 


1 = A A A Be i A 2 
CO A a ee regs i Mode 
ee ee eee Ue ae ee ee ee 


The condition codes for BSET are: 


Re ie 


N Not affected 
Z Set if the bit tested is zero, cleared otherwise 
V Not affected 
C Not affected 
xX Not affected 
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Program Relative with 
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Address Register Direct . 
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Postincrement 
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Address Register Indirect Indexed with 
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Starting the Debugger. .... - 
To Debug an Existing Program 
To Insert a New Program... 
Debugging the Program . ...-+-+-+-« >» 
DEF DEFine external symbol. ..... .- 
DELETE. << « « + a vig Gr. Te Shem alee: a YR Hee a 
DIV DIVide signed ee ae ae ee ee 
DIVU DIVide Unsigned. . . : 
Directives. . ee A ; . 
ASECT absolute SECTion ; ; 
COPY COPY filename... é 
DATA define DATA... . : 
DEF DEFine external symbo ‘ 
DSECT Dummy SECTion. . . , 
END END of program... . : 
EQU EQUate .. « ‘ 
a 


1 


FORM FORMat definition of data 
Extended Use of FORM-symbo 
ORG ORiGinate program. ...-+ «+ -« 
PAGE new PAGE. ...-.+ «© © « © « -» 
Program Sections . .. +++ +e -» 
RDATA Repeat DATA. ....-.-. - 
REF REFerence external ee ‘ 
RES REServe. . i a 


RSECT Relocatable SECTion. 
TEX? TEXT StEInG: 4. ~ ° 
TEXTC TEXT string with Count 
TITLE TITLE OF page. « « .« « 
DSECT Dummy SECTion .« <« « « « « 
BOLEOr, THE 4. “ee 4) SO ae Bi eS 
Entering an Editor Command . 
Hine NUMbering < <. «. s> 6 es 
Loading the Editor .... . 


Referencing Program Lines. 
Sample Session ..... - 
Specifying Strings .... - 
Work and Scratch Files... 
Editor, Loading The «<< « « -« # 


Editor Command, Entering an. . 
Faditoer ‘Comands... 4. 4. sk Se eS 
CHANGE 0a we ec, es a hp Ae cee a 
CONGR E g.) ee a a SO ea eS ee er 
DE i ae Ul. Se a a a ce a ee ey ee 
TNSERT oc Ke ae eS ae Se SR Se SA We eS Sas 
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(Quit Debug with Debug OFF Command) 
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INO @ ) ® 
UW 


IO ce! ah sea at She gh ee eo Sg 
DOO EE a> a, Bhs gO ye Ady et a Ge 
BOM aE LOR: ea cy Lee Ga, a oe Os 
PEIN a tk) ae. hoe ae eh Ge Be eh od 
Ee ee Ga os See Ge ak, Be US Goma cae tp 
RELABEL. 


SO i rcge igh tte a gs Ree AR ee a ed te 
RUPE? sak Gea) Way ces ek Qe Te 
SPE ROENG ce eee oo, wi ee ca Ma 
TAs @ “+x eee ae Cat UE. =e 
END END of program, a ae cee ee 
HOU BOUA CG ee gs a Mie age Sg ee eh ew 
Error/Warning Messages. ..... 
Linker Error Messages. ... 
List of Assembler Errors and 
Executing the Program. <« « s « « 
Expressions .., Soe See ee 
FORM FORMat definition of data. . 
Extended Use of FORM-symbol. 
Immeagiate Data, . « i-« - *« «= «4% 
PMpPPLGre AdAressing.2- Aig! aot & 
EINGra dy: ae ag. Le ce ae Ve ee SB ee os 
Instruction Fields. Oe? a ee ee eae? 
INSEPUCTION -FOrmate ce «9c 4c oS 
IRSURUGCTIGN Groups <=: 2 ac 2) en 
PUEEEUCCIONS « <6. a ok Ge ek se ae 
COHGLELON COdeSs. <4 2 2 ex 
Instruction Groups ..... 
INSErUCEION FIeldas. « -.) <4 
BV Wa a oe lhe. ee ee Sy ae 
ADD binary. .. 4 ae eae ae 
ADD quick/immediate. a ae 
ADD address register .... 
ADD data register. ..... 
ADDC binary with Carry ... 
ADDD Decimal (BCD) with exten 


AND (LOG 7Ca)cANDy. . 4-4 a as 
AND logical AND immediate. . 
AND logical AND data .... 
Bee Branch on condition. .«. .« 
BR BRanch control addressing 
Be a ge woe te ves ee ee ag eo, 
BRR BREAK. « a w « « ee 
BRKV BReaKkK on overflow , 
BO ae ies a Gi et he ue ee ga aw og 

Bley sh ge. <a ae te erie set cas ae 

CALL general .... . 

CHK CHecK against bounds ee 
CLR CLeaR an operand . 


CMP CoMPare e e e@ e e e@ e e 6 
CMP COMPare immediate. ... 
CMP CoOMPare memory ..... 


CMP COMPare address. .... 
CMP COMPare data « «= £2 «~~ 


DBcc test condition Decrement and B 


DIV DIVide signed. ..... 
DIVU DIVide Unsigned .... 
EAT sign ExXTended. . . « «. 
Bb bCal- Gata Aico oa a as Sen ge 
LD LoaD condition codes. .. 
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LD LoaD data register. « .« « « « » « 
LD LoaD address register ..... - 
TDA. LeabD Address . « «© «<< «= # « «= * 
LDM LoaD Multiple... ; 
LDP LoaD Peripheral data : 
LINK LINK and allocate. . 
MOV MOVeG 2. «© 3% & eS «© © 
MOV MOVe address register. . 
MOV MOVe from SR ..... - 
MOV MOVe general ..... - 
MOV MOVe to condition codes. 
MUL MULtiply signed. ... . 
MULU MULtiply Unsigned... 
NEG NEGAtCG « « +» @ « * «© «© @ <6 “e © * 
NEGC NEGate with carry. . ee de 
NEGD NEGate Decimal (BCD) with extend 
NOP NO OPeration «. « « 4 «= « + «< « % 
NOT logical NOT. «-« 2 <4 «= < 6 -s 

OR logical OR. + « « «= « s « 
OR logical OR immediate... 
OR logical OR data .... .- 
PUSHA PUSH Address .... . 
RET RETurn from subroutine . 
RTR ReTurn with Restore. .. 
ROdc ROtate. .. o cee 
ROL ROtate Left logical. mot 
ROL or ROR ROtate Logical. 
ROL or ROR Rotate logical data 
ROL or ROR Rotate logical memory 
ROLC or RORC ROtate with Carry. . 
ROLC or RORC Rotate with Carry memory 
ROLC Rotate Left with Carry (extend) 


ROLC[1] or RORC[1] Rotate with Carry data 


ROR ROtate Right logical... . 

RORC Rotate Right with Carry (extend). 
SETOC SET On COndItION « <« « « « « % 
SHdc SH1IfC. .. « ; 


SHL and SHLA SHift Left “Logical/Arithme 


SHI; or SHR Shift Logical . «= < ~~. 
SHL or SHR SHift logical data. . . 
SHLA or SHRA SHift Arithmetic. . . 
SHLA or SHRA SHift Arithmetic memor 
SHLA[1] Shift Arithmetic data. 
SHR SHift Right Logical. ... 
SHRA SHift Right Arithmetic. . 
SHift logical memory .... .- 
ST STOre 4 « % ; a a ae a ee 
ST STore data/address register... 
ST STore status register ..... - 
STM STore Multiple . . . « «© « «© « * 
STP STore Peripheral . 

SUB SUBtract .... - 
SUB quick/immediate. 
SUB address register 
SUB data register. ... 
SUBC SUBtract with Carry 
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SUBD SUBtract Decimal (BCD) with extend. 


TEST an Operand., « « 6 % «+ &<@ s & 
TEST Gata register . ss « « « 
TEST immediate .-4 6 & « So Se «a «= 
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TESTCLR1 TEST and CLeaR ee 


TESTCLR1 data register 
TESTCLR1 immediate .. 


TESTNOTL TEST and NOT bit. 


TESTNOTL data register 
TESTNOT1L immediate . . 


TESTSET TEST and SET indivi 


UNEK UNGINKs 4 2. % an 4 
ACH @xCHange ~ 2 4 « « 


eXCHange registers. 


eXCHange words. . 


XOR eXclusive OR logical 


XOR eXclusive OR data. 


XOR eXclusive OR immediat 
Assembling 


Intermediate File, 
DADC LS sce Va so) Ge a She tas ee 2S 
LD LoaD address register. . 
LD LoaD condition codes . . 
DD: GOap. gatas < G&G) £42 Soe 4 
LD LoaD data register ... 
LD LoaD status register . 
LDA LoaD Address. .... 
LDM LoaD Multiple .... 
LDP LoaD Peripheral data. 
Gane Numbering, «. 9° 2 a. % 
Linker. THe... 4.6 4. 

Error Messages . 
BITOLrS:. 


Pata «. 
Warnings. 
Example. .. : 
Linker Command, The 
Linker Map, The. —- 
Allocation Map. 
Definition Map. 


Linker Control Listing. 


Summary e e e @ e 


S 


Undefined Reference Map 


Linker Options .... 


L (Create Map File) 
O (Output Program File) 
P (Print Linker Map on Printer) 
T (Print Linker Map on Terminal). 
Preparing a Linker Control File. 
Creating an Object File . 
Creating the Control File 


od) Sa a 

INCLUDE. & + 

ORIGIN 2.0 «4 
Linker Output Format. ... 
Linking an Absolute Program 
TLS ese vac SS ak : ss 
List, of Errors and Warnings 


Listings 
Assembler. .... 
lanker-«. %. % ; 


Long Absolute ... 


Loading the Editor. a 
Memory Address Modes. , 
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Memory Map. ... +. +« © «© «© « © © « » 
Memory Organization . . .. +. +s. e« -» 
MOGMOn1CS ¢ < ~ «= %- A eee Ee Se & = 
MOV MOVG.s < & & < @ 3S “S @ co 4% & Se. x 
MOV MOVe address register ..... .- 
MOV MOV (from SR << 4 2 6.4 eS SS S 
MOV MOVe general. ....-.-.+ + «© « «» 
MOV MOVe status register. ..... - 
MOV MOVe to condition codes .... . 
MOV MOVe user stack pointer ..... 
MOV Be -s. ar ee oe Oe, Se Re es ce 
MUL MULtiply signed br a Se A oe, ee 
MULU MULEIplY Unsigned. « « 4s « 's: % 
NEG NEGate. .. . er ee ee 
NEGC NEGate with carry. is <i ee a ase Sa oe 
NEGD NEGate Decimal (BCD) with extend 
NOP No OPeration. .... 
NOT logical NOT 5.4 4° 24 
Object Code Description . 
General Structure. . 

Plex Types... : ‘ P 
Declare Symbol Reference. * 

Declare Program Entry Point 

Define Processor. .... . 

Define Program Section. . . 

Define Section Length... 

Define SYMDOL «6 6 % a = 3 

Load Constant Data. .... 

Load Constant Repeat Data . 

Load Data with Reference. . 

Select S@Ction.. «.<« « <« » % 

Select Section ORG... . 

Operands. .. ee ae a) Bae ae a Me 
OR inclusive OR status register .. 


OR logical OR oa 6. Je, ce Svs: GAs 
OR logical OR data. Bio AR oth seh tae ie 
OR logical OR immediate ....... 
ORG ORiGinate program . .....« -« 
PAGE new PAGE ..... «© « «© e« © « « 
Plex TyV0eS.- 4 << e AOS SS “8 Se Od Be GS 
POS LTTION. «. a a @ “oe 26 «ow 2 @ oes 
PRENE gc esc wR Se ec ee Ow. Re Oe 
Privileged Instructions A sa ces fay es Ne 
AND AND status register. gig waet ele 
LD LoaD status register. ... . 
MOV MOVe status register ae 
MOV MOVe user stack pointer. ge 8% 
OR inclusive OR status register. 
RESET RESET external devices . . 
RETI RETurn from Interrupt... 
WAIT WALT for interrupt. .. « 
XOR eXclusive OR status register 
Program Counter . . .. +. + «© © «© « « 
Program Lines, Referencing. . . 
Program Relative. . ... + +++. » 
Program Relative with Index. . 
PUSHA PUSH Address. .....-.-« -« 
OULTy. a> ok <a. cs A. <tem Hl A a Ga See, ce 
RDATA Repeat DATA ir ° ae ee ee 
REF REFerence external symbol a 


Reqieter Direct Modes: 2. 4) 4-“e 4 <> se 
Register/Mode Codes ........6.. 
Regis Sec oe arn he Ne Mee ee aca da een ete A 
Address Registers. . ....... 
Condition Code Register 
Carry Bit... = 
Extend Bit. . 
Negative Bit. 
Overflow Bit. 
DOO BULL 3. 3 
Data Registers .. 
Program Counter. . 
Status Register. . 
System Stack Pointe 
User Stack Pointer .. 
RETR ENS te ee Re OR es es as 
RES REServe .. 
RESET RESET external “devices 
RET RETurn from subroutine. 
RETI RETurn from Interrupt. 
ROdG “ROtCECG 4. 4. 2 4- % ; 
ROL or ROR ROtate Logical Ns oe 
ROL or ROR Rotate logical data. ...« . 
ROL or ROR Rotate logical memory. ... 
ROL: .RObSCe Lett “logical 5.4 1-4 ~~ <= % 
ROLC OF -RORC: ROtatG with Carry. « <. «<« 
ROLC or RORC Rotate with Carry memory . 
ROLC Rotate Left with Carry (extend). . 
ROLC[1] or RORC[1] Rotate with Carry dat 
ROR ROtate Right logical. .. ‘ , 
RORC Rotate Right with Carry (extend) . 
RSECT Relocatable SECTion . , 
RTR ReTurn with Restore .., ‘ 
Sample Programs ...... . 
Sample Session. .. ee see ae Noy 
Assembling an Intermediate File. 
Creating a Source File ..... 


r 


Debugging the Program. .... 

Executing the Program. ... 

Linking an Absolute Program. 
SEA Wag ge igh eh ah eee pS Tae sha ee ‘ 
BHARCH «gs ee ae ae 3 
SETCC SEPT ‘on condition. , e: % 
SHGC SHI. 6's ia 2 ote e: 3 
SHift logical memory. .. a 
SHL and SHLA SHift Left Logical/Ari 
SH te SAR -OULEC GOGICAL, -. «ats «ag: ne! 44 
SHL -OF ‘SHR SHift logical data... .~ . «= < 
SHLA or SHRA SHift Arithmetic ..... 
SHLA or SHRA SHift Arithmetic memory. . 
SHLA(E] Shift: Arithmetic data. . 5 ..., 
Short Absolute. .. Be a ae ae, See oe 
SHR SHift Right Logical ete ei wg ae ak 
SHRA SHift Right Arithmetic ...... 
Side by Side Listing Format . 
Source File, Creatinga... 
Special Address Modes .... 
Specifying a Register Directly 
specifving a Valtie.. «<< «as « 
Specifying an Address ..... 


1 


ta 
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Speciiving Strings. « < « «+ 
Statistics Listing< « « «= = « 
Status. Register «5. 4 « « « 
STM STore Multiple. .... 
STP STore Peripheral. .. . 

So UR LNG:. 60S. “eS oe tay a a 

Or STOR... ~ ea 
ST STore data/address register 
ST STore status register. . 
SUB address register. ... 
SUB data register ..... 
SUB quick/immediate .... 
SUB SUBEract.. 4 «@--s ‘ 
SUBC SUBtract with Carry. 


SUBD SUBtract Decimal (BCD) with exten 


Syntax. « ‘ 
System Stack Pointer. ; 
LER we | Ge ate ‘ ‘ 
TITLE TITLE of page ‘ 
TEST an operand... 
TEST data register. . 
TEST immediate. ... 
TEST. PEST Bit. . ) s 
TESTCLR1 data register. 
TESTCLR1 immediate. .. 
TESTCLR1 TEST and CLeaR 
TESTNOT1 data register. ... 
TESTNOT1 immediate. ..... 
TESTNOT1 TEST and NOT bit. . 


oR 
- 
ctr 
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TESTSET TEST and SET indivisible 


THT TEXT St rind... -< «a ‘ 
TEXTC TEXT string with Count. 
UNGK UNBIOR a & ws < % «= 
User Stack Pointer. .. . 
WAIT WAIT for interrupt . 
Work and Scratch Files. . 
SCH exCHange. x. 6 6 “= « + 

eXCHange registers . 

eXCHange words... 
XOR eXclusive OR data ..... 
XOR eXclusive OR immediate. .. 
XOR eXclusive OR logical. .. . 
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XOR eXclusive OR status register. 
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